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Infragistics - formed by the merger of Sheridan and ProtoView 



45 Award Winning Components included in UltraSuite 2.0: 



Grid 

>UltraCrid™2.0 

Office/Outlook- 
style Ul 

>Data Explorer™ 
>Outlook Bar 

Toolbars 

XJItraToolBars™ 

Tree 

>ActiveTreeView" 



Calendaring 
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>Calendar 

>DayView 

>TaskPad 

>DateEdit 

>TimeEdit 

Advanced DB 
Components 

>ComboBoxEx 
>DropDownEdit 
>HotLink 
>Spin 



>ComboBox 
>Listbox 

Tabs 

>ActiveTabs™ 

Data Input 

>Currency 

>Numeric 

>MaskEdit 

Resizers 

>Resizer 

>Resizer (works with 
non-client area) 



Advanced Ul 
Components 

>Scroll 

>Splash 

>Transition 

>Marquee 

>Picture 

>ProgressBar 

> Frame 

>Option 

>Command 

>Ribbon 

>Check 

>Splitter 



>Panel 
>Dial 

>Font Selector 

>Line3D 

>Multibutton 

>Shape3D 

>Text3D 

Utility Components 

>ScreenPrinter 
>PropertyBrowser 
>lmageCombo 
>ColorCombo 
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We've combined our best-of-breed products into one positively jam-packed solution. Along with 
the familiar, easy-to-use interfaces of Microsoft Outlook, Microsoft Office and Windows Explorer, 
UltraSuite provides the most innovative grid available-UltraCrid2.0, and our UltraToolBars is 
loaded with functionality. With 45 controls, we've included everything necessary to create 
solutions that look great and run efficiently, faster than ever before. There's nothing like the 
productivity, flexibility and support of UltraSuite. 

You can really sweeten the deal-UltraSuite 2.0 is available with optional Subscription Service, or 
upgrade to the UltraSuite Enterprise Edition (includes subscription and guaranteed rapid response). 
Automatically receive all major upgrades (full version releases) and minor updates (enhancements 
and service releases) during your subscription period.* Make the most of your investment-you'll 
find the rewards can be "Suite". 



For detailed information, visit 
www. i nf rag i sties .com 

Download Free Trial Version! 
Order Online! or call 800-231-8588 
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Component powered infrastructure 
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Web server farms have always been known for providing high 
application availability in a cost-efficient manner. Unfortunately, in 
the past they have also been known for manageability headaches. 
But no more: Microsoft Application Center 2000 now makes managin 
Web applications and groups of Web servers as simple as managing 
a single server. 

Part of the flexible Microsoft .NET Enterprise Server family, Application 
Center 2000 is built to be the heart of a "scale-out" infrastructure 
model. "Scaling out" is a flexible approach to scalability that involves 
deploying Web applications across multiple servers to distribute and 
handle the workload. 

Application Center 2000 makes scaling out easier, with unified 
Web application and server-farm management that simplifies tasks 

like cluster management and 
application deployment. Plus, it 
makes it easy to achieve capacity 
on demand through automatic 





replication of applications when 
you add servers or make changes 
to existing applications. But 
simplicity is not all you get: 
Application Center 2000 offers increased uptime through dynamic 
load balancing and by having no single point of failure. 

In sum, Application Center 2000 removes the hassle of managing multiple 
servers separately, while providing the availability and cost-efficiency of 
a "scale-out" model. Find out how to keep the odds in your favor: visit 
microsoft.com/applicationcenter Software for the Agile Business. 
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• VSFIexGrid Pro 7.0 
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Write to the NT Event Logs 

Writing to the NT event logs is a necessity for professional 
applications, but dealing with the event logs can be complex. 
Here's how to simplify your work, 
by L.J. Johnson 
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Install Databases a Better Way 

Install databases in a 
new way using SQL- 
DMO and Data 
Transformation 
Services (DTS). This 
offers added flexibility 
and smaller file sizes, 
by Josef Finsel 
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Target Multiple 
Devices 

You don't need to know 
tons of device-specific 
languages to make your 
Web pages accessible to 
different devices. You can 
serve Web pages to 
multiple devices 
dynamically by creating 
a custom server control 
in .NET. 
by Dan Wahlin 
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C# Explorer 

Delve Into Delegates 

One of the most common misconceptions among 
developers learning C# is that delegates are "just like 
function pointers." In reality, C# delegates represent a 
significant leap forward in functionality, 
by Steve Lardieri 

72 

Web Services 

Use COM+ Services With .NET Components 

COM+ services aren't going anywhere — you still need 
them to build enterprise-class, distributed applications. 
Thanks to attributes and dynamic registration, it's easy 
to create .NET components that use them, 
by Alan Gordon 
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2001 



APPLICATION DEVELOPER'S 
PROGRAM 




Big idea? 

Big opportunity. 



As the first event of its kind sponsored by 
Sprint PCS, the Sprint PCS Developer's 
Conference 2001 is your ticket to the cutting 
edge. Join us for an inside look at the products 
and services shaping the wireless future. 

Our speakers, tutorials and exhibitors will help 
you turn your big idea into a successful wireless 
application. Conference topics include: 

9 Monetizing Your Application with Sprint PCS 

• Location Services-Access to Other Network 
Data and Resources 

• Mobile Commerce and Advertising 

• Sprint PCS Migration to 3G and Packet 
Switched Services 

• New Devices and Development Platforms 

• Future of JAVA on Mobile Devices 

For more information about Sprint PCS 
Developer's Conference 2001, visit us online at 
http://developer.sprintpcs.com. Of course, you 
can also register with the Sprint PCS Wireless 
Web Application Developer's Program anytime 
to access useful tools and resources for 
compelling application development. 



Join us for two days of 

knowledge and relationship building 



10.11.01-10.12.01 

Caesars Palace | Las Vegas 



Register today! 




Sprint PCS E 



© 2001 Sprint Spectrum LP. All rights reserved. Sprint, Sprint PCS and the 
diamond logo are trademarks of Sprint Communications Company LP. 
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Getting Started 

Build a Task Scheduler 

Build yourself a custom task-scheduling 
engine, fueled by a reusable ActiveX 
DLL. Also learn to create scheduled apps 
you control through command-line 
parameters. 

by Stan Schultes 
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82 

Best Practices 

Learn When to Use 
N-Tier Designs 

An n-tier architecture isn't always what 
your application needs. Here's a 
roadmap for when to use n-tier logical or 
physical architecture and when to use 
single-tier or two-tier designs, 
by Rockford Lhotka 

86 

Desktop Developer 

Kill Your App Gently 

Microsoft's Knowledge Base doesn't tell 
you everything you need to know about 
shutting down an application. Here's 
how to kill applications appropriately. 

by Karl E. Peterson 
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Q&A 

Extract Color Values Painlessly 

Split color values into their components, 
give a 3-D border to a borderless form, and 
work around the Timer control's 16-bit 
interval limit. 

by Karl E. Peterson 
94 

Expert XML 

Generate and Read 
XML Documents 

If you've been struggling with using the 
DOM or SAX to read and write XML 
documents, take heart: .NET offers a 
better way. XmlWriter and XmlReader 
make your XML parsing and generation 
much more efficient. 

by Yasser Shohoud 
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document 
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ASP.NET 

Automate Text Graphics Creation 

Take the pain out of creating text labels 
to spiff up your Web sites. Use ASP.NET 
to create a WebForm that lets users 
specify label requirements. 

by A. Russell Jones 



104 

Database Design 

Use Batches for 
Faster Throughput 

Sending multiple commands and using 
stored procedures speeds up your 
database processing operations. Here's 
how to optimize your use of batches in 
SQL Server, 
by John Pearson 
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Black Belt 

Emulate VB.NET Error Handling 

Visual Basic has a long history of less- 
than-robust error handling. But you can 
change that right now, with minimal 
fuss, by implementing a structured 
exception-handling mechanism to 
extend VB6's native capabilities, 
by Darin Higgins 
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Cj visit us at programmersparadise.ee 



FREE Catalog 



100+ pages of products 
and information 
for developers! 

Get a FREE subscription 
to our catalog by calling 
800-445-7899 
or subscribe at 
' programmersparadise.com , 



Paradise Picks 



New 
Version!} 



"OOTUrra 



Mozquito FML for HomeSite 

by Mozquito Technologies 

Adding the interactive dimension 

Mozquito FML for HomeSite brings the strength 
and agility of XHTML-FML to Allaire's easy-to-use 
editor HomeSite. Mozquito Technologies trans- 
formation engine, Mozquito Matrix, translates the 
files into a format all major browsers can display. 
Benefits: 

• Includes 20 new XHTML-FML tags 

• Checks your XHTML documents for 
validity and well-formedness 

• Enables FML document preview in your 
favorite browsers 

• Is a simple-to-use environment 

• Contains tags for performing client-side 
calculation and input validation 

• Lets you create multiple pages in a 
single document 

• Create online forms, surveys, quizzes 
and more with just a few tags. 



Paradise # 
M3A 011B-GC 



$0099 



NASDAQ : PROG 



programmersparadise.com 
or call 800-445-7899 




VSVIEW® 7.0 Reporting Edition 



Paradise # 
C18 0150-GC 
SAOO 99 



by ComponentOne 

ComponentOne VSVIEW Reporting 
Edition adds powerful, flexible 
database reporting to one of our 
most popular ActiveX 15 controls, 
VSVIEW Classic Edition. Now you 
can quickly and easily create 
Microsoft® Access-style database 
reports for your Visual Basic, VC++, 
and C++Builder applications, plus 
preview, print, and export those 
reports on your computer or over 
the Web. 



Intel® Software Performance Tools 

by Intel 

Build Faster Applications, with 
Help Straight from the Experts 
Who Know Processors Best. 

VTune™ Performance Analyzer non- 
intrusive sampling and call graph 
profiling offer multiple ways to 
understand code performance. 
Intel" C++ Compiler* designed from 
the ground up to take full advantage 
of Intel's latest processors. 
Intel" Fortran Compiler* delivers 
outstanding application performance 
with advanced features like Profile- 
Guided Optimization. 




* Sold separately. 
Call for pricing on compilers. 

VTune Performance 
Analyzer 
Paradise # 
I23 01 53- GC 




Paradise # 
C29 0420-GC 

$ 119." 



SPF/SourceEdit 3.5 

by Command Technology 
SPF/SE provides file 
management and editing similar 
to ISPF for Win95/98/200u7NT 

Features include: Variable or fixed length 
records; Record lengths to 64,000; File 
size to 100M; ASCII or EBCDIC character 
set; Multiple line numbering modes; 
Hex display/modify; Source colorization; 
Powerful file lists; Projects; "C" macro 
language; and much more. 



Download a 
demo today. 



programmersparadise.com 
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B19 0761-GC 

5 2,899. £ 



Borland JBuilder 
5.0 Enterprise 

by Borland 

Rapidly create Enterprise JavaBeans"" 
and Web applications. Deploy to the 
leading J2EE'" e-business platforms — 
Borland 8 ' AppServer"', BEA* WebLogic®, 
and IBM* WebSphere 8 . Improve 
team productivity with Rational* 
ClearCase®, CVS, and Microsoft* 
Visual SourceSafe™ integration. 
Publish and exchange data using XML. 
Find out for yourself why JBuilder is 
the 41 Java development environment. 
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FarPoint's Spread 
3.5-New Version! 

by FarPoint Technologies 

Use FarPoint's Spread 3.5 to easily 
incorporate high-level spreadsheet 
and advanced grid features into 
your applications. You get unmatched flexibility at the cell level for 
maximum control over the display and entry of your data, plenty 
of events to respond to user changes and an impressive feature 
list for everything in between, including: import/export capabilities; 

enhanced printing; 1 2 cell types, formulas; 
Paradise # and an improved Spread Designer. 
F02 0133-GC /Iv^H 
SO O"! 99 > Version' < 

*66l . \^sj 



FARPOINT 

TECHNOLOGIES INC 




Paradise # 
L05 0480-GC 

$ 419." 



LEADTOOLS Imaging 

by LEAD Technologies, Inc. 

LEAD'S award-winning imaging 
technology is chosen by Microsoft, 
Hewlett Packard, Intel, Boeing, Xerox, 
and thousands of other companies for 
use in their high-volume applications 
and internal systems. LEADTOOLS gives 
developers the most flexible and powerful 
imaging technology available: forms; 
recognition; PDF; EPS + postscript 
support; import/export; compression; 
image processing; color conversion; 
display/special effects; Internet/intranet; 
annotations; medical imaging; OCR; 
barcode recognition; and much more! 




TX Text Control 9.0 

by The Imaging Source 
TX Text Control Does it All. 

A powerful programming component which 
allows developers to easily add into their 
application sophisticated text formatting 
and display capabilities typically seen only 
in large word processing programs. 

Download a 
demo today. 



Standard Ed. 
Paradise # 
T79 0136-GC 

s 412." 



Professional Ed. 
Paradise # 
T79 0134-GC 

s 785." 
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TestTrack" 

by Seapine Software™ 

TestTrack Pro and Workgroup are the most 
powerful defect tracking solutions for Web, 
Windows, Macintosh, Linux, and Solaris. 
TestTrack Pro 4 delivers a robust solution 
by providing source control integration; 
data field customization; XML and ODBC support; customer and 
user test configurations; e-mail notification; e-mail bug importing; 
duplicate defect handling; release note generation; and unlimited 
customer care. TestTrack Workgroup 2.0 delivers a rich feature set 




for smaller teams. 




2.0 Workgroup Ed. 
Paradise # 
S96 0140-GC 

$ 173." 



4 Pro Ed. 
Paradise # 
S96 0170-GC 

$ 210." 



Call 800-445-7899 or visit programmersparadise.com 



Tremendous Selection! 

Personal Service! 
Jf§ ^ Guaranteed Best Prices! 




PR-Tracker 




10-24 Users 
Paradise # 
S3R 0142-GC 

$ 99 
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PR-Tracker 



by Softwise Company 
Bug Tracking... doesn't 
have to be expensive! 

Integrate bug tracking over the Internet 
and a local area network in one database 
with the same easy-to-use interface. 

PR-Tracker's simple yet powerful 
interface requires no training and 
enables you to configure a project in 
about 15 minutes. Features include: 
customizable data entry, workflow, 
views and queries; one click queries; 
attachments; and email notification. 

* Price per user. 




Paradise # 
T34 0170-GC 

$ 463." 



DevTrack 

by TechExcel 

Powerful Defect Tracking 

DevTrack is the premier defect- and 
project-tracking tool for software 
development teams, helping to ensure that 
development projects finish on time and on 
budget. DevTrack comprehensively tracks 
and manages all defects, change/feature 
requests, and all other development issues. 
DevTrack also provides powerful workflow 
and process automation features, robust 
searching and reporting, and comprehensive 
point-and-click customization. Intuitive and 
powerful, DevTrack provides a scalable out- 
of-the-box solution, at a great value. 




Paradise # 
S84 0D70-GC 

? 2,399." 



PowerBuilder 8 
Enterprise Edition 

by Sybase 

PowerBuilder 8 is the easy-to-use, scalable, 
and proven rapid application development 
environment that provides a cost-effective 
migration path to next-generation archi- 
tectures while simultaneously protecting 
existing investments. It eases Web and 
distributed development by providing 
seamless application server integration 
through full development, testing, 
debugging, and deployment processes. 

I Sybase 

Ispohmation Anywhere. 



ORACLE 




Call for 
Pricing 



Oracled/ Database 



by Oracle 

The Oracleft' Database has been designed 
for the emerging hosted application market 
on the Internet. OracleS/ meets and exceeds 
the most stringent demands for high quality 
of service for this new, service-driven 
marketplace. With transparent, rapid-growth 
clustering capabilities, powerful and cost 
effective security measures, zero-data-loss 
safeguards and real-time intelligence, 
Oracleft' will get your business where it 
needs to be for the next Internet. 



Inti 
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RoboHelp® Enterprise 

Discover How People Are 
Using Your Help System 

RoboHelp Enterprise is intelligent 
server-powered Help software 
that provides: 

• User feedback reports to update 
and improve the effectiveness of 
your application and Help system 

• Superior natural language search 

• Support for team development and 
fast project merging at runtime. 



* Limited time pricing. 




Paradise # 
SOZ 0250-GC 

$ 189." n 



SourceOffSite Pro Ed. 

by SourceGear Corp. 

Access SourceSafe" 
over the Internet 

Visual SourceSafe collaboration tool 
for distributed teams. 

• IDE integration 

• Over 1 times faster than RAS 

• Efficient — uses data compression 

• Secure — up to 128-bit 
data encryption 

• Familiar — the look and feel of VSS 

• Cross-Platform — Windows and UNIX. 

ft Pro edition, 1 user. 



Visual SlickEdit® v6.0 

by MicroEdge, Inc. 

Source code analysis, side-by-side 
file comparison, extensive language 
support, easy to implement and 
configurable to your coding styles. 
New Java capabilities including 
Java Tool Integration for setting 
compile, execute, debug, javadoc 
and jar options. 



Paradise # 
M39 0151-GC 

$ 268." 



Download a 
demo today. 
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dtSearch Web 

Add instant searching to your site! 

• Over a dozen text search options 

• Highlights hits in XML, HTML & PDF 
while keeping links & images intact 

• Converts word processor, database, 
spreadsheet, ZIP, etc. to HTML for 
display with highlighted hits 

Point & click setup 

Includes dtSearch Desktop with Spider. 

Ask about: dtSearch Network & dtSearch 
Text Retrieval Engine with sample code 
in multiple programming languages. "A 
tremendously powerful and capable text 
search engine"— Visual Developer. 




Should you see one of these products listed at 
a lower price in another ad in this magazine, 
CALL US! We'll beat the price, and still offer | 
our same quality service and support! 
"Terms of the offer: 

• Offer good through September 30, 2001 

• Applicable to pricing on current 
versions of software listed 

• September issue prices only 

• Offer does not apply towards 
obvious errors in competitors' ads 

• Subject to same terms and conditions 
Prices subject to change. 
Not responsible tor typographical errors. 
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InstallShield Express 3.5 

by InstallShield Software Corporation 

Go from zero to setup to Internet the easy 
way — in less than a day! Just follow the 
easy-to-use InstallShield Express checklist 
environment. Visually build your setup. Include 
third-party technologies. And finally deploy 
on the Web. No scripting. No learning curve. 
And the most economical solution available: 
InstallShield Express! 
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121 064B-GC 
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TeeChart Pro 



TeeChart 
Pro ActiveX 
Version 5 

by Steema Software 

The hottest in COM Charting for Windows and 
the Web! Extensive example code for ASP/IIS, 
Visual Studio, Office and more. Multiple export 
formats, Multiple axes, Multiple Chart types in 
2D, 3D and OpenGL. Custom Canvas, Grid, 
Toolbar, built-in ADO and .NET support and 
many specialist financial functions including 
MACD, ADX and Stochastic. 



Download a 
demo today. 



programmersparadtse.com 



Paradise # 

SOT0113E-HP* 



S-JQ0 85 



In Canada— call 1 -888-423-2700 (www.pparadise.on.ca) 
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Web Deployment Wizard 




• Welcome to the Web Deployment 
Wizard 



The Web Deployment Wizard allows you to build your setup 
for a quick Web deployment. 



Click Next to proceed or Cancel to exit. 



Industry-Standard Installations out of the Box in Minutes. 



You need quick installation development. And that 
means easy-to-use. But you won't sacrifice quality to 
get it. No sweat. Your answer is InstallShield Express. 

InstallShield Express is the easiest and most 
economical solution for quickly developing 
straightforward setups. An intuitive checklist guides 
development. You just point and click through one 
section, check it off, and move on to the next. In just 
six quick steps, you complete everything necessary 
to build your installation. 

Remember: a robust application doesn't necessarily 
mean a complex setup. If you need to copy files, 
make registry edits, install third-party run-time 
executables, or even deploy on the Web, InstallShield 



Express can have you covered in no time, getting 
software to your users faster— even beating your 
competition. 

And now InstallShield Express features 
One-Click Install™ Web deployment technology. 
Your users get one seamless experience right through 
download and installation, skipping "save as" dialogs 
and avoiding endless file searching. And you get to 
digitally sign and password-protect your setups. 

Plus One-Click Install features let users avoid 
downloading several setup components 
if they already exist on their PCs— speeding things 
even more. Your customers will use your software 
sooner, have fewer hassles, and develop an even 



better opinion of your technology. Speedy 
development. And speedy Web delivery. All with 
InstallShield Express. 

So find out more. An evaluation copy of InstallShield 
Express is available from our Web site. But with such 
value available at so tempting a price, why not order 
today? With our 30-day money-back guarantee, you can 
get your hands on the full product risk-free and right 
away. And of course the award-winning InstallShield 
support team is available for help on any challenge. 

So there you have it. Ease of use. The security of the 
industry standard. And most importantly, the speed you 
crave. So rush to www.installshield.com and find out 
more right now! 
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it's an InstallShield setup. So everyone knows it works and works well. Here's a few of the features that make it 
InstallShield Express. 



i Checklist Design Environment 
Visual Basic Project Scanner 
Static and Dynamic File Dependency Scanners 
VBScript, DLL, and EXE Custom Actions 
One-Click Install™ Web Deployment 
14 World-Wide Languages 




• Advanced Compression Option 

• Nearly 50 Third-Party Technologies 

• Upgrade Authoring 

• Dialog Text Editor 

• Windows XP Support 

• Upgrade to InstallShield Developer 



GET YOUR FULL-FEATURED EVALUATION 
ATWWWJNSTALLSHIELD.COM 




© 2001 InstallShield Software Corporation. All rights reserved. 
InstallShield is a registered trademark and service mark of 
InstallShield Software Corporation. All other trademarks are 
the property of their respective owners. 
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Get the Most Out of 
Visual Studio 



Welcome to the premiere issue of Visual Studio Maga- 
zine. This new magazine targets those who develop 
applications using the tools that ship with Visual 
Studio, including Visual Basic 5/6 and Visual Basic.NET, C#, 
SQL Server, and ASP.NET. As noted previously in Visual Basic 
Programmer's Journal {VBPJ) and in letters to subscribers, Visual 
Studio Magazine subscriptions replace existing VBPJ and Visual 
C+ + Developers Journal (VCDJ) subscriptions. 

Visual Studio Magazine (VSM) provides the information you 
need to make the most of Visual Studio — from drilling down on 
application fundamentals to creating desktop and client/server 
apps, and from programming Web services to implementing the 
best database designs. Each issue explores how to implement 
solutions with practical, hands-on, tested code that focuses on 
what's possible today but points you toward tomorrow. You'll 
get tips, techniques, and answers from developers who work on 
the cutting edge of enterprise development, including Bill 
Storage, Andrew J. Brust, Juval Lowy, Richard Grimes, and 
Roger Jennings. You'll learn what works in the real world — 
and what doesn't. 

VB.NET and C# are highly similar at their core. They share 
the same framework and its base classes — well over a thousand 
and counting. In the great majority of cases, a solution that uses 
VB.NET also applies to a C# developer, and vice versa. We'll 
take advantage of this similarity by including both VB.NET and 
C# versions of code online for articles that cover such solutions, 
where possible and appropriate. 

VBPJ was long the premier source for in-depth, independent 
content on programming with Visual Basic. VSM continues in 
that vein — we will cover VB in all its versions to the extent that 
you use it and want to read about it — drawing on longtime VB 
experts such as Karl E. Peterson and Francesco Balena. To that 
end, VSM includes a monthly column called Desktop Developer 
that shows you how to implement solutions involving traditional 
nuts-and-bolts Windows desktop development, such as mouse 
and keyboard tips and how to write more efficient algorithms. 
Karl provides the debut Desktop Developer column, explaining 
how to shut down other applications properly. 

VSM is your premier source for information on all varieties of 




What topics do you need 
to read about? E-mail us at 
vsmedit@fawcette.com. 



VB, but it covers much more 
than that, providing solutions us- 
ing the most popular tools that 
ship with Visual Studio. For ex- 
ample, VSM 's extended column 
lineup helps you take advantage 
of the technologies most relevant 
to you. VSM includes a column 
on XML, another on ASP.NET, 
and yet another on best practices. 
The Best Practices column covers 
the design and architecture issues 
you face when creating applica- 
tions. It explains when to use in- 
heritance and when to avoid it; 
the best way to set up classes; the 
best approaches for creating a re- 
sponsive, intuitive UI; and more. 
We'll take care in this column to 

discuss the tradeoffs of various design approaches to help you 
achieve better performance in a given environment — whether 
you're implementing a traditional desktop, client/server, server- 
side, or Web application. 

Another feature of this magazine: a special, FCD/-labeled sec- 
tion devoted to using C++ and C# — brought to you exclusively 
by the former editors of VCDJ. 

We're committed to making this magazine the first place you 
look for practical, hands-on, everyday development information. 
To do this, we need to hear from you. You can e-mail me directly 
at ednote@fawcette.com or e-mail the VSM editors as a group at 
vsmedit@fawcette.com. 

We've also set up an online survey area at www.ftpresearch. 
com/vsmag. We'll tailor the magazine to fit your needs better 
by updating this survey each issue, using the feedback we 
collect from both the surveys and the e-mail you send us. This 
month, one lucky person who fills out the September 2001 
survey will receive a Palm Illxe PDA. (You must submit your 
survey by September 1 5 th to be eligible.) We look forward to 
hearing from you. vsm 
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Develop Better and Faster TODAY! 




LiveJ 



Visual Studio Developer Conference 

ORLANDO • OCTOBER 9-14 

Register by AU9»^ ' UDITQ 

SAVE $200 — ^ i/jjj J b 




800-848-5523 
^.vslive-comNsm 
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Over 180 Hours of ALL NEW 
Technology for the .NET Platform, 
C#, XML, T-SQL and more! 

♦ FULL BONUS DAY ON .NET! 

♦ Explore the Bleeding Edge of Web Development 
with VB, ASP.NET, C# and XML 

'lunge into Windows XP and Web Services 

♦ Exploit Data Access with ADO.NET, SOAF! and T-SQL 

♦ PLUS: Hailstorm Architecture Unleashed 

Call 800-848-5523 to Register 
Visit www.vslive.com/vsm 
for More Details 
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Conference, XML Magazine and SQL2TheMax are trademarks of Fawcette Technical Publications, Inc. Visual Studio is 
used by Fawcette Technical Publications, Inc. under license from Microsoft. All other trademarks are property of their 
respective owners. 
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From: Bill Gates (Microsoft) 
Sent: Thursday, June 14, 2001, 11:49 AM 
To: Developer & IT Professionals 
Subject: Microsoft .NET Today 

What will the next generation of the Internet look like? Many of us envision an online world where constellations of 
PCs, servers, smart devices and Internet-based services can collaborate seamlessly. Businesses will be able to share 
data, integrate their processes, and join forces to offer customized, comprehensive solutions to their customers. And 
the information you or your business need will be available wherever you are— whatever computing device, platform 
or application you are using. 

That vision has yet to be achieved. In many respects, today's Internet still mirrors the old mainframe world. It's a 
server-centric computing model, with the browser playing the role of dumb terminal. Much of the information your 
business needs is locked up in centralized databases, served up a page at a time to individual users. Worse, Web 
pages are simply a "picture" of the data, not the data itself, forcing many developers back to "screen scraping" to 
acquire information. And integrating that underlying data with your business's existing systems— never mind those of 
your partners— is a costly and frustrating challenge. 

Compounding this frustration is the fact that today's standalone applications and Web sites create islands of 
functionality and data. You have to navigate manually between Web sites, devices and applications, logging in each 
time and rarely being able to carry data with you. You have to keep constant track of which particular application or 
device or Web site gives you which level of access to which particular data. Tasks that ought to be simple— such as 
arranging a meeting with colleagues from partner companies and automatically updating every attendee's calendar- 
are a nightmare. Productivity is one of the main casualties. 

Solving such problems is the key challenge for the next generation of the Internet. At the heart of the solution is 
extensible Markup Language, or XML. An open industry standard managed by the World Wide Web Consortium, XML 
enables developers to describe data being exchanged between PCs, smart devices, applications and Web sites. 
Because XML separates the underlying data from how that data is displayed, the data itself is "unlocked" so that it 
can easily be organized, programmed, edited and exchanged between any Web sites, applications and devices. XML 
is a lingua franca for the Internet age. Just as the Web revolutionized how users talk to applications, XML transforms 
how applications talk to each other. 

As developers become more familiar with XML, they are moving beyond simply using it for data. With the help of XML- 
based technologies such as SOAP (which enables applications to interoperate via standard Internet protocols) and 
UDDI (which gives businesses a standard way to describe their services and connect automatically), they are creating 
a new type of software that uses XML to provide Web-based services. These XML Web services are programmable 
and reusable, much like component software, except that they are accessible anywhere via the Internet. Programs 
using this model will run across multiple Web sites, drawing on information and services from each of them, and 
combining and delivering them in customized form to any device. 

How will businesses and their customers benefit from this? Because XML Web services break down the distinctions 
between the Internet, standalone applications and computing devices of every kind, they enable businesses to 
collaborate to offer an unprecedented range of integrated and customized solutions— solutions that enable their 
customers to act on information any time, any place and on any device. 

The power of the XML Web services model is amazing. A company offering an online electronic-payment service can 
expose its service to partners, so that they can deliver it as part of their own offering— regardless of what platform 
they are using. An airline can link its online reservation system to that of a car-rental partner, so travelers can book 
a car at the same time they book a flight. An online auction company can notify bidders when they are outbid or have 
won an auction, or could partner with other firms to offer alternative shipping, fulfillment or payment options. XML 
Web services help your business break free of its boundaries. 

With XML Web services gaining momentum among developers as the next generation of Internet-based computing, 
it's time to deliver a platform that makes it simpler to build these solutions and provides a reliable framework for 
integration and interoperability. Such a platform must be based on open standards, so it can work across all 
programming languages, operating systems and applications. And it must combine the power of PCs and smart 
devices with the richness of the Internet. 

Microsoft's platform for building, deploying, operating and integrating XML Web services is .NET. In the next few 
pages we'll describe .NET, explain its many benefits, and set out a roadmap for transforming your business to take 
advantage of everything it has to offer. 

Chairman and Chief Software Architect 



As a result of the changes in how businesses and consumers use the Web, the industry is 
converging on a new computing model that enables a standard way of building 
applications and processes to connect and exchange information over the Web. This new 
Internet-based integration methodology, called "XML Web services," enables applications, 
machines, and business processes to work together in a way never previously possible. The 
widespread support around XML within the developer community assures that 
businesses will thrive and cooperate in the accelerated, Internet-based economy with this 
XML Web services model. 



The first principle of XML Web services 
is that systems connect through the 
Internet— a safe assumption given the 
high availability and low-cost connectiv- 
ity provided by the Internet. Second, 
there needs to be a simple way to "find" 
services on the Internet with which 
businesses can work. UDDI (Universal 
Description, Discovery, and Integration — 
www.uddi.org) is a broad industry effort, 
involving companies such as Microsoft, 
Ariba, COMPAQ, Dell, HP, IBM, SAP, and 
many others, which provides a way to 
locate and understand services pro- 
vided by other companies. It's a kind of 
"yellow pages" on the Internet for the 
industry. 

Third, a common language is needed to 
ensure that information is shared with 
others. XML is the ingredient that makes 
this possible. XML provides a common 
data format so that you can continue to 
work with data and information in a way 
that doesn't require business partners or 
customers to use a particular program- 
ming language, application, or operating 
system to interact with your systems. The 
final principle is that there must be a way 
to actually conduct business-for ex- 
ample, to call the service, book the 
appointment, order the part, or deliver 
the information— through a common 
protocol. This protocol is called SOAP 
(Simple Object Access Protocol). It 
enables systems to talk to one another 
and make requests. SOAP is the new 
model for Internet native integration. 

These four principles enable you to 
connect, find, transform, and transact 
across systems, applications, and 
processes to deliver XML Web services. 



XML Web services are flexible technol- 
ogies that bind disparate systems across 
different languages, unifying personal 
computing, enterprise computing, and 
the Web. As long as the fundamental 
communication occurs via XML Web 
services, each system can be indepen- 
dent from the others, with each "service" 
running on entirely different systems, 
even in different parts of the world. 

The benefits of XML Web services are 

far-ranging and will be instrumental in 
propelling explosive business growth 
over the next few years. Businesses will 
be able to: 

Easily integrate with other businesses 
using XML Web services. Your software 
will easily integrate with other pieces of 
software— from the desktop to the main- 
frame-both within your enterprise and 
at external sites. These integration 
capabilities enable you to forge closer 
ties with business partners and pursue 
best-of-breed integration of business 
processes. 

Develop applications faster. As the pool 
of XML Web services grows, developers 
will be delivering more and more soft- 
ware and services, including legacy 
applications, that operate within the 
XML Web services programming model. 
If there is existing code that can help you 
solve your problem, you can find it and 
integrate with it through XML Web ser- 
vices, instead of reinventing it. 

Easily implement personalization. 

Integration with external data sources 
is part of the XML Web services pro- 
gramming model. This makes it 



possible for you to request information 
and transform data by whatever means 
necessary to deliver individualized 
software and services. Your mainte- 
nance burden is reduced because you 
no longer have to collect and maintain 
this information on an application-by- 
application basis. 

A New User Experience. Employing 
XML Web services provides benefits for 
both consumers and businesses. 

Consumers will enjoy unparalleled 
ease of use when they use applications 
built with XML Web services. Because 
XML Web services link applications, 
services, and devices together as con- 
nected solutions, software arrives as 
part of an integrated experience that 
offers simplicity in computing. XML Web 
services give users the ability to act on 
information any time, any place, from 
any smart device. 

For businesses, implementing software 
projects using XML Web services 
solves many of today's supply-chain and 
demand-chain integration challenges. 
With its industry-standard communica- 
tion interfaces, an XML Web service is a 
simple, reliable way to blend existing 
systems with new applications and 
services. 

Microsoft .NET- 

An XML Web Services Platform 

With the momentum behind XML Web 
services growing among developers, 
Microsoft is building a platform to help 
them write, deploy, and manage these 
services. Microsoft 8 .NET is that plat- 
form. It contains both products and 




Your Company 



Auction 


Notification 


Service 


Service 











H 










V - - Expedia 

XX Si 





















- 


□ 




M 








CD 




1 



Dollar 

CLIENTS XML WEB SERVICES 

XML Web services can be leveraged in endless combinations to create User Experiences. 



SERVERS 



services developers need to build and 
run XML Web services, and enables 
some of the User Experiences that 
demonstrate the integration of XML 
Web services with the universe of com- 
puters, smart devices, and Web-based 
services used by consumers. 

Microsoft .NET is optimized for XML 
and XML Web services, but it is by no 
means the only choice of develop- 
ment platform. Because XML is an 
open standard, created and managed 
by the World Wide Web Consortium 
with the input of many computer- 
industry companies, the products and 
services within Microsoft .NET will 
interoperate with a broad set of XML- 
and XML Web services-enabled infra- 
structure and developer tools from 
other vendors. With over 5 million 
developers skilled on Microsoft tech- 
nology, the development community 
is poised to begin mass delivery of 
XML Web services. 
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In two weeks, programmers built, 
tested, and deployed a Microsoft 
solution that translates reserva- 
tion requests and data between 
Dollar* Rent-A-Car's VMS-based 
reservation systems and an 
airline partner's UNIX servers. 
Because XML Web services 
powered the solution, Dollar can 
reuse that same integration 
model to link with any number 
of partners. 



MICROSOFT .NET PRODUCTS AND 
SERVICES 

Developer tools and technologies. A 

productive set of tools is critical to 
developer success on a new platform 
like .NET. Visual Studio.NET and the 
Microsoft .NET Framework supply a 



complete solution for building, deploy- 
ing, and running XML Web services. 
They help you maximize the perfor- 
mance, reliability, and security of your 
XML Web services. 

Visual Studio.NET is the next generation 
of Microsoft's popular multi-language 
development tool, built especially for 
.NET. Visual Studio.NET helps develop- 
ers quickly build XML Web services and 
applications that scale easily, using the 
language of their choice. Visual 
Studio.NET advances the following 
high-productivity programming lan- 
guages: Visual Basic* which includes 
new object-oriented programming fea- 
tures; Visual C++? which advances 
Windows'-based development and 
enables you to build .NET applications; 
and C#, which brings RAD to the C and 
C++ developer. In addition to these 
languages provided by Microsoft, 
there will be over 20 languages pro- 
vided by partners, including Perl, 



XML-Enabled Products & Services 


PRESENT 


FUTURE 




Client Operating Systems 


Windows 2000 Professional Windows Me 
Windows CE 


Windows XP Professional 
Windows XP Home Edition 
Windows XP Embedded 

\A/i nHniiic fE "Tolicl/nf" 
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Smart Devices 


Pocket PC Mobile Explorer™ 


Xbox 
Tablet PC 
Smart phone code-named "Stinger" 
UltimateTV* 


User Experiences 


MSN Explorer Visio* 2002 
Office XP 


Next version of Office 
Next version of Microsoft Project 
Next version of Visio 




Building Block Services 


Passport 


"Hailstorm" Services 




Developer Tools 


Visual Studio 6.0 Visual Studio.NET Beta 2 
SOAP Toolkit 2.0 .NET Framework Beta 2 


Visual Studio.NET 
.NET Framework 
.NET Compact Framework 




Servers 


Windows 2000 Server ISA Server 2000 
Windows 2000 Advanced Server BizTalk Server 2000 
Windows 2000 Datacenter Server Application Center 2000 

SQL Server 2000 SharePoint Portal Server 2001 
Exchange 2000 Server Mobile Information 2001 Server 
Commerce Server 2000 Content Management Server 2001 
Host Integration Server 2000 


Next version of Windows 
code-named "Whistler" Server family 

Next version of SQL Server 
code-named "Yukon" 



• Developer tools and technologies- 

the latest version of the Microsoft 
SOAP Toolkit for XML Web services 
and betas of Visual Studio.NET. 

Leading-edge IT organizations, like 
Dollar Rent-A-Car, Expedia.com, and 

others, use these products today to 
build high-value XML Web services that 
solve today's integration and interoper- 
ability problems. For example, when 
CheckSpace offered its electronic pay- 
ment processing capabilities through 
an XML Web service, it expanded its 
market reach to new small-business 
customers, resellers, and online mar- 
ketplaces that used a variety of 
computer systems and accounting 
packages. Those new customers now 



enjoy streamlined accounting pro- 
cesses and more efficient cash-flow 
management. 

FIVE EASY STEPS 

Now is the time to prepare your com- 
pany to take advantage of XML Web 
services. Five easy steps lead to 
the future: 

1. Educate yourself and your IT depart- 
ment about XML Web services and 
Microsoft .NET; 

2. Investigate Windows 2000, Office XP, 
and the Microsoft .NET Enterprise 
Servers as a way to upgrade the XML 
capabilities of your systems and 
infrastructure; 

3. Download and evaluate betas of 
Microsoft's developer tools; 



4. Create pilot projects that test XML 
Web services; and 

5. Insist that your vendors have at 
roadmap for making their applica- 
tions accessible as XML Web 
services. 

A subscription to MSDN* Universal 
delivers the developer tools and 
servers you need to learn about .NET. 
Microsoft also offers .NET Readiness' 
Training, which teaches the technical 
foundation for creating XML Web ser- 
vices and instructs you on using tools 
like C# and Visual Studio.NET. 

Get started and learn more. For more 
information about XML Web services and 
Microsoft .NET, visit microsoft.com/net 



The information contained in this document represents the current view of Microsoft Corporation on the issues discussed as of the date of publication. Because Microsoft must respond to changing 
market conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information presented after the date of publication. 

This document is for informational purposes only. MICROSOFT MAKES NO WARRANTIES. EXPRESS OR IMPLIED, IN THIS DOCUMENT. 

€' 2001 Microsoft Corporation. All rights reserved. Microsoft. bCentral, BizTalk. Mobile Explorer. MSDN, MSN, SharePoint. UltimateTV. Visio 2002. Visual Basic. Visual C++. Visual Studio. Windows, and' 
Xbox are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. The names of actual companies and products mentioned herein may be ti 
trademarks of their respective owners. 



Python, Cobol, and Eiffel, from which 
developers can choose. 

The .NET Framework is a high-produc- 
tivity, standards-based, multi-language 
application execution environment that 
handles essential plumbing chores and 
eases deployment. It provides an appli- 
cation execution environment that 
manages memory, addresses version- 
ing issues, and improves the reliability, 
scalability, and security of your applica- 
tion. The .NET Framework consists of 
several parts, including the Common 
Language Runtime, a rich set of class 
libraries for building XML Web services, 
and ASP.NET, the next generation of 
Active Server Pages. 

Server infrastructure. XML Web ser- 
vices should be built on a 
next-generation infrastructure that 
offers developers the benefits of mod- 
ular architecture, economical and 
linear scaling, security, reliability, man- 
ageability, and high availability. The 
.NET Enterprise Servers and the 
Windows 2000 Server family make up 
the Microsoft .NET server infrastruc- 
ture for deploying, managing, and 
orchestrating XML Web services. 
Designed with mission-critical perfor- 
mance in mind, they provide enterprises 
with the agility they need to integrate 
their systems, applications, and part- 
ners through XML Web services, and 
the flexibility to adapt to changing busi- 
ness requirements. 

The Windows 2000 Server family is 
Microsoft's secure, scalable founda- 
tion for running the .NET Enterprise 
Servers and the next generation of 
business applications. 

The .NET Enterprise Servers are: 

• Application Center 2000 to deploy 
and manage highly available and 
scalable Web applications; 

• BizTalk™ Server 2000 to build XML- 
based business processes across 
applications and organizations; 

• Commerce Server 2000 for quickly 



building scalable e-commerce 
solutions; 

• Content Management Server 2001 

to manage content for dynamic 
e-business Web sites; 

• Exchange 2000 Server to enable 
messaging and collaboration, any- 
time, anywhere; 

• Host Integration Server 2000 for 
bridging data and applications on 
legacy systems; 

• Internet Security and Acceleration 
Server 2000 for secure, fast Internet 
connectivity; 

• Mobile Information 2001 Server to 
enable application support by 
mobile devices like cell phones; 

• SharePoint™ Portal Server 2001 to 
find, share, and publish business 
information; and 

• SQLServer™ 2000 to store, retrieve, 
and analyze structured XML data. 

Services. An XML Web services model 
offers developers an opportunity to 
achieve economies of scale by utilizing 
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XML Web services will help 
Expedia.com 1 * transform itiner- 
aries into communication 
centers— allowing travelers to 
pick distinct notification set- 
tings for different members of 
their integrated contact list. 
By providing customers with 
relevant and timely informa- 
tion at their convenience, 
Expedia will continue to attract 
new customers and further 
strengthen the loyalty of their 
existing customer base. 



a set of core XML Web services that 
releases developers from the burden 
of building everything themselves. By 
integrating with these core services to 
perform routine tasks, developers can 
concentrate on building high-value, 
business-critical XML Web services. 
Microsoft Passport is the first such 



service, providing authentication ser- 
vices for over 160 million accounts. 
Microsoft and many other companies 
plan to develop more core services for 
users and enterprises. 

Clients. Microsoft will support XML 
Web services across the full range of 
smart clients so that your customers 
can access your XML Web services 
regardless of location or type of 
device. Some of the clients Microsoft 
offers include Windows CE, Windows 
Embedded, Windows 2000, and the 
upcoming Windows XP. These clients 
will power PCs, laptops, workstations, 
smart phones, handheld computers, 
Tablet PCs, Xbox™ game consoles, 
and many other smart devices. 

User Experiences. A good User 
Experience pulls together all of the 
XML Web services and client software 
a particular user needs, and presents 
everything to the user in an integrated 
way that makes sense— even if it calls 
on XML Web services run by other com- 
panies on other machines. Microsoft 
will deliver User Experiences for know- 
ledge workers, consumers, enterprises, 
small businesses, and developers. 
Some of the products that Microsoft is 
transitioning into User Experiences are 
Microsoft Office, MSN", bCentral™, 
and Visual Studio.NET. 

YOUR PATH TO XML WEB SERVICES 

Microsoft is delivering the product line 
to put your business on the path to 
XML Web services today: 

• Windows 2000 Server— the reliable 
infrastructure for the linear, cost- 
effective scaling required by the XML 
Web services world. 

• The .NET Enterprise Servers— the 
foundation for running, managing, 
and securing XML Web services. 

• XML Web services— Passport. 

• XML Web service-capable clients- 
Windows 2000, Windows Me, 
Windows CE, Office XP, and soon 
Windows XP. 



A Revolution Is Upon Us. Revolutions are a way 
of life in the computer industry. Only 20 years 
ago, the world was still in the mainframe era. 
Few people had access to or used computers, 
and when they did, it was only through the 
nearest IT department. The PC, the graphical 
user interface, and the introduction of the 
Internet changed all that. They democratized 
computing for hundreds of millions of people 
and transformed the computer into a mass- 
market product. 

Since then, standards such as HTML and HTTP 
have exponentially increased people's use of the 
Internet. This base protocol for viewing content 
on the Web (and the associated software for 
"browsing" this content) grew Web usage to 
what it is today— a key activity in the daily lives of 
business employees and consumers. 
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sual Studio 



Imagine what you can create 
with the right components. 



DBI has been helping the world's top developers build 
better apps for years. With DBI scheduling components 
you'll exceed all expectations... even your own. 





Solutions::PIM 
Professional 
Seventeen personal information 
management components 
designed to work together. 
Multi-column day view, week view, 
calendars, alarms, date and time 
edit control — all use common 
properties and events for seamless 
integration into any application. 



Calendar Tools 
Five fast, easy to use drop-in calendar 
components including monthly and 
yearly calendars, drop date edit control, 
scrolling calendar and more. Calendar 
Tools is an affordable, functional 
component solution to meet your 
design needs. 
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Solutions: :Schedule 
Schedule up to 32,000 
entities at a time and present 
the schedule in increments 
of hours, days or weeks. 
Schedule multiple lines 
for each entity with a wide 
variety of time-bar styles. 
Drag and drop time-bars 
within the schedule. 
The ideal solution for 
employee and resource 
scheduling. 



Technologies Inc. 



put it together 



Download a free trial version: www.dbi-tech.com 
or call toll free: 1-800-670-8045. 
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Don't Stop With VB.NET: 
TryC# 



Well, here we are. All comfy and cozy in our new home, 
Visual Studio Magazine ( VSM). In spite of the name 
change, though, we realize a big majority of you are 
primarily VB developers with no particular wish to change 
languages. And that's great. Each issue, you can count on VSM 
to keep giving you the most practical hands-on, how-to VB 
techniques and code you can find. 

That said, I'd now like to state for the record that I think 
you're doing yourself a huge disservice if you don't also start 
acquainting yourself with C#. 

I expect you now have two questions on your mind. First: 
Did Microsoft pay you to say that? No, it didn't. In fact, 
Microsoft seems to have made a point recently of taking a neutral 
stance in the VB.NET vs. C# debate. Its current mantra runs 
along the lines of "Both VB.NET and C# are fully CLR- 
compliant. It doesn't matter which you use. It's your code; it's 
your choice." And I concur: If you're a VB developer and you're 
planning on doing .NET development, you should focus on 
VB.NET. I maintain, however, you should still learn C#. 

Which brings me to the second question I'm guessing is on 
your mind: Why? 

Because you can. Learning to develop for .NET with any 
language is going to be a major project . . . the first time. 
Understanding and leveraging the Framework, using Web 
Services, and dealing with ASP.NET and ADO.NET (to name 
only a few examples) will all be hard work. Once you've got 
your head around .NET using VB, however, learning to do the 
same things (plus a little more, occasionally) with C# will not 
be that hard — the differences are primarily syntactical. And 
then you've got another major skill to put on your resume. 
That's a good thing. 

Because it's going to be on other platforms. By December 
of this year, ECMA — an international association that evaluates 
and approves proposed communication and information 
standards — will likely have finished its review of C# as a freely 
available, public-domain language. After that, it's only a matter 
of time before it appears on other platforms — Unix, Mac, Palm, 
and who knows what else. If you're a VB developer who's been 
frustrated at times by being restricted to the Windows platform, 




Have you started learning C#? 
If you have, how do you like 
it? If not, well why not, for cry- 
ing out loud? Write to me at 
realitycheck@fawcette.com. 



Microsoft — ironically — has given 
you a path leading to a larger 
world, courtesy of C#. 

Because it's a good language 
for .NET development. I 
recently attended the 200 1 Tech 
Ed conference, where I had the 
chance to speak one-on-one with 
several developers working on 
.NET products. No matter what 
we talked about, I always worked 
in one question: Have you begun 
developing with C#? Without 
exception, those who have started 
programming with C# have good 
things to say about it. The fact is, 
Anders Hejlsberg had .NET in 
mind when he invented C#, and 
it shows. 

Because it's Microsoft's "dog food." Microsoft wrote the 
.NET Framework classes using C#. Now, bear in mind, the 
company couldhzve coded it in VB.NET just as well — VB.NET 
is not a red-headed stepchild. The fact remains, however, that 
Microsoft used C#, making it a robust, well-tested .NET 
language in the process. If at some time Microsoft releases source 
code for the Framework, any serious developer will want to read 
it — and you'll need to know C# to do so. 

Visual Studio Magazine sees C# as an important language; 
expect continuing coverage. Assuming you're willing at least to 
give C# the benefit of the doubt, be sure to check out the new 
monthly C# Explorer column, occasional C# features, and 
supplemental C# code available for download for many of our 
VB.NET articles. 

.NET is obviously a huge initiative for Microsoft, and it 
presents developers like you with unheard-of possibilities. 
Knowing how to develop for this new set of technologies — 
whether you're using VB.NET, C#, or something else — is going to 
improve your value as a programmer. Knowing C# will increase 
your value even more. VSM 



Visual studio Magazine • September 2001 • www.vbpj.com • www.vcdj.com 



15 



Getting from point to point 



Whether you need to get Visual Studio® and Web server applications 
up and running in a flash, or will be making the move to the 
Microsoft® .NET™ Framework, ComponentOne makes the journey 
quick and easy. 
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Tools 



Looking to toster a community on 
your Web site or intranet to improve 
employee knowledge, increase 
user-to-user interaction, and encourage 
customer feedback? No matter what 
your goals, ComponentOne has the 
ideal communication solution. 

VSFORUM" 2.0 

Customizable 
or intranets 



Reporting Tools 

You know the challenges of presenting 
and sharing critical enterprise information. 
Whether you require powerful, reliable 
reporting or need to preview, format, 
print, and export documents, rely on 
ComponentOne for the most flexible 
reporting solutions. 

• VSVIEW 7.0 Classic Edition 

Document viewing, formatting, print previewing. 
anO exporting 

• VSVIEW* 7.0 Reporting Edition 

VSVIEW Classic, plus Microsoft Access-style 
database reporting 

• True DBReports'" 6.0 

High-performance reporting lor Microsoft 
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True DBList Pro^ 

Download your eval copy today! 



CD 
0) 



CD 
Q. 



INSTITUTE 











fern 










MM 



[mi. 1 1 ,« 



Product 



NEW! 



Documentation Tools 

Need painless ways to produce Microsoft 
HTML Help, WinHelp, and standard HTML; 
automatically document ActiveX controls; 
and add spell-checking and thesaurus 
functionality to your apps? The search is 
over with ComponentOne's complete 
documentation solution. 

• True Help'" 1.0 

Trte essential Help authoring tool for 
Microsoft Word 

• VSDOCX™ 1.0 

Automatic ActiveX control documentation 

• VSSPELL'" 6.0 Classic Edition 

Spell-checker and thesaurus for Visual Basic 
applications 

• VSSPELL " 6.0 International Edition 

VSSPELL Classic, plus add-on British English, 
Spanish, and Dutch dictionaries 



Development Tools 

Everything you need to develop database 
front-end applications, create and distribute 
dazzling charts, and rapidly build an 
OLE DB Provider. When you need robust, 
easy-to-use data access and presentation 
tools, rely on the ComponentOne 
development solution. 



Data Access Tools 

• ComponentOne Query'" 1.0 

End-user ad hoc query builder 

• True DataControl™ 6.0 

Enhanced data control for Microsoft Visual Studio 

• True OLE DB Provider " SDK 

The "build an OLE DB provider in one week, 
not one year' SDK 



Data Presentation Tools 

• True DBGrid* Pro 7.0 

The enterprise grid 

• VSFIexGrid s Pro 7.0 

The agile grid 

• True DBInput" Pro 6.0 

Data-aware ActiveX input controls for Microsoft 
Visual Studio 

• ComponentOne True DBList " Pro 7.0 

Supercharged DBList and DBCombo controls for 
Microsoft Visual Studio 

• ComponentOne Chart'" 7.0 

The ultimate charting tool lor distributed applications 

• ComponentOne WebChart'" 7.0 

The ultimate charting tool tor browser-independent 
Webserver applications 

• ComponentOne SizerOne'" 7.0 

Four-in-one resizing, tabbing, and parsing tool 

• Olectra' Resizer 2.0 

Resizing control lor code-free resolution 
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ComponentOne tools cover the full range 
of your development needs! 

No other company offers our complete series of high-performance 
tools for Visual Studio development and Web server applications, 
our upcoming innovative products for Microsoft .NET Framework 
and emerging technologies, and our responsive team dedicated to 
providing top-notch service and support. 

When you need to get from idea to application quickly and easily, the 
path is clear. Trust the performance, support, and value you can only 
get from ComponentOne tools. Download your eval copies today! 
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East Coast Office: 1 .800.858.2739 or 1 .41 2.681 .4343 • West Coast Office: 1 .888.228.4839 or 1 .51 0.496.3240 
ComponentOne'" LLC • 4516 Henry Street • Pittsburgh, PA 15213 • USA 
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Letters to Visual Studio Magazine are 
welcome. Letters must include your 
name, address, and daytime phone num- 
ber to be considered for publication. 
Letters might be edited for form, fit, and 
style. Please send them to Letters to 
the Editor, c/o Visual Studio Magazine, 
209 Hamilton Avenue, Palo Alto, CA 
94301 -2500; fax them to 650-853-0230; or 
e-mail them to vbpjedit@fawcette.com. 

Stop the Product Bickering 

I appreciated Andrew J . Brust's Guest Opin- 
ion, "Cross the Other Digital Divide" [Vi- 
sual Basic Programmer's Journal]une 200 1 ] . 
I am so sick and tired of these little IT 
development camps bickering and disre- 
specting each other. And I don't like being 
made to feel that just because I've focused on 
using Microsoft products, I've somehow 
sold out. 

All this is just hot air until it comes to 
hiring time: Should someone who's an ex- 
perienced SQL Server developer be passed 
over for a position developing for an Oracle 
database in the absence of an available Oracle 
developer? I don't think so. 

I think learning any of the major data- 
base and/or development technologies in 
depth makes a great foundation for learning 
the competitors, but people rarely consider 
this as an option. It's as if we all have to fit 
into these little cookie-cutter categories that 
the HR people are comfortable with: He's a 
VB guy, she's a C++ gal, he's a SQL guru, 
she's an Access pro, and so on. 

The same concept applies to the type of 
development as well: Sometimes desktop 
development experience can be used as a 
foundation to become an "enterprise" appli- 
cation developer. People who "get it" can 
understand more than just the one niche 
product in which they've focused their ef- 
forts. They usually just need the opportunity. 

Tony W. Robinson, Lexington, Ky. 

How Microsoft Killed VB 

I, unlike many of my peers, believe that 
Microsoft has finally gotten it right with 
Visual Basic.NET. The new VB has grown 
up and can no longer be kicked around by 
the C bigots of the world, as I've thought in 
the past. 

However, here's where I think Microsoft 

went wrong: Microsoft is touting C2# as the 

new open programming language of choice 
(read: ECMA standardization) and yet is 
keeping VB as a proprietary language. What 



gives? It's as though Microsoft is afraid of 
losingus3millionVB programmers. Microsoft 



VSM's Sister Publications 

The September issue of Exchange & 
Outlook magazine (http://exchange. 
devx.com) introduces two new col- 
umns. Improve YourOutlookwill help 
you learn how to use more features 
in the application you use most, and 
The Migration Exchange will share 
tips and tricks from an expert on the 
frontlines on moving from Exchange 
5.5 to 2000. You'll also get a first look 
at Microsoft Mobile Information 
Server, which provides the ability to 
wireless-enable existing Windows or 
Web-based applications. 

The September issue of Java Pro 
(www.javapro.com) explores how the 
Java Authentication and Authorization 
Service (JAAS) extends Java's exist- 
ing security infrastructure. It also in- 
cludes articles on how to access data 
sources through the Apache Xang in- 
terface and how to use Java servlets to 
isolate data presentation from busi- 
ness logic in your Web site. Learn about 
the generics extension to Java that's 
scheduled to be released in JDK 1.5. 

The August/September issue of 
XML Magazine (www.xmlmag.com) 
continues its coverage of XML in ubiq- 
uitous computing with a feature ar- 
ticle discussing Microsoft's Hailstorm 
and .NET, Sun Microsystems' Sun ONE 
platform, Symbian's Java strategies, 
XHTML, VoiceXML, and the competi- 
tion for control of the pervasive com- 
puting platform. XML pioneer Adam 
Bosworth contributes a column dis- 
cussing currentXMLtechnologies, and 
this issue also introduces a column 
featuring XML-Java topics. The issue 
also introduces the MSXML3.0 parser 
on Windows CE, which includes in- 
corporating the parser in your own 
applications. 

Fawcette Technical Publications 
has partnered with MightyWords 
(www.mightywords.com/index.jsp) to 
offer several technical articles. ".NET 
and COM: Working Together" by Brian 
Noyes and "Microsoft .NET Strategy 
Defined" by Stuart Johnston and Andy 
Patrizio are available for purchase and 
download on the site. 
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The World's Most Powerful 
Mapping Components 



With MapObjects, you can quickly and 
easily build mapping capabilities directly 
into your applications. MapObjects includes 
more than 45 embeddable mapping compo- 
nents that you can use in any standard 
Windows development environment such 
as Visual Basic, Visual C++, and others. 

MapObjects gives you unparalleled data 
support and a wide range of useful features: 

• Support for CAD drawing files 
and a variety of image formats 

• On-the-fly map projection 

• GPS management 

• Geometric functions 

• Advanced geocoding and more! 

Because MapObjects is from ESRI, the 
world leader in geographic information 
system (GIS) technology, you can be 
confident that you are receiving industry- 
standard, technologically superior mapping 
and GIS functions. 

Download a FREE evaluation version of 
MapObjects from ESRI online. 



MapObjects 2.1 is now available! 
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Letters 



has failed to realize chat to keep from losing 
us, it should have never created C#. Why 
couldn't it simply have gone with Managed 
C++ and VB? Why spend the time and 
money supporting two similar programming 
languages? Given that the languages are prac- 
tically identical, why on earth would a VB 
programmer want to code in a proprietary 
language when given the choice to use an 
open language (one that is extremely close to 
Java)? Think of the career possibilities. 

It's no wonder that Microsoft has 
dropped the ball(mer) here. All of us VB 
developers owe a ton of gratitude to Bill G. 
VB was his big cheese. He made program- 
mers out of all of us. 

Alex Calvo, Wallingford, Conn. 

VFP: The Real Story 

Thank you for your Editor's Note, "An Ode 
to VB's Unsung Heroes" [Visual Basic 
Programmer's Journal}u\y 2001]. Those of 
us who use Visual FoxPro don't often see 
our development tool mentioned and feel 
like it's the Microsoft "stepchild." Bits and 
pieces of VFP have found their way into 
other Microsoft products such as Rushmore 
(Jet), and ActiveX Data Objects (ADO) is 
based on the VFP cursor engine. 

Again, thank you for your fine article. 

Tom Whiteley, Sunnyvale, Calif. 

Understand OOP Distinctions 

I enjoyed Deborah Kurata's Programming 
With Class column, "Get the Most From 
OOP" [Visual Basic Programmer's Journal 
June 2001]. Ironically, Tip 6, "Use XML," 
is sandwiched in between Tip 5, "Pass Pa- 
rameters," and Tip 7, "Define Interfaces," 
without regard to the fact that using XML 
injudiciously allows the developer to elimi- 
nate parameters and interfaces! 

This happens to be a pet peeve of mine 
these days. I am encountering developers 
who have begun to develop the habit of 
passing data between functions as a complex 
XML string rather than as discrete param- 
eters. "No interface," rhey say. "No more 



compatibility problems." This casual ap- 
proach to interface compatibility completely 
disregards the fact that a physically compat- 
ible interface is of no use when the logical 
contract has been broken. And having to 
memorize the undocumented formats of 
these complex XML strings, which don't 
provide IntelliSense to the client developer, 
is certainly undesirable. 

I have found XML effective for serializ- 
ing a component's state, especially across 
application tiers. This is especially conve- 
nient where, as a matter of internal imple- 
mentation, the class maintains its state in an 
XML Document Object Model (DOM) to 
begin with. 

I have also found XML useful for passing 
complex data sets between functions where 
the amount of data is either large or can vary 
dynamically. However, in these cases, I al- 
ways provide a companion class with a defi- 
nite interface so client developers can build 
the XML string through the companion class's 
defined interface. After the client is finished 
interacting with the companion class, then 
that class's .XML property is used to serialize 
the class's internal XML DOM as an XML 
string that's passed to the server function. 

Joseph Geretz, Monsey, N. Y. 

I received several e-mails such as yours that 
discussed the technique of wrapping the XML 
string in a class that exposes the properties as 
property procedures. As you mentioned, this 
approach has several benefits. Youcanuse VB's 
Auto List Members feature to see the list of 
properties. None of the developers need to know 
anything about XML andean still work with 
it effectively through the class properties. 

The downside is maintenance. If you add a 
field, you need to add a property to the class. 
Using XML directly, without a wrapper class, 
you can add fields to the tables without changes 
to the business objects. This is useful primarily 
for fields that don 't require business logic; they 
only need to be entered, stored, and retrieved 
later. As more developers move toward the 
concept of iterative development, there's more 



need for frequent changes. So using XML as 
the parameter to the function can simplify the 
development efforts greatly. 

The bottom line: There is no one right 
answer that applies in all circumstances. You 
need to look at the project's objectives and 
constraints. If one of the objectives is to provide 
self documenting functions by way of param- 
eters and/or property procedures, the wrapper 
makes sense. If you plan to do deliverables 
every three weeks, adding functionality itera- 
tively, you might want to opt for the second 
approach. — D.K. 



Get the Code 

Use these Locator+ codes to download the code for 
this issue of KSAfatwww.vbpj. com orwww.vcdj.com. 



VS0109: All the listings and code files for the Sep- 
tember 2001 issue of VSM'm one ZIP file 
VS0109LJ: "Write to the NT Event Logs": all code 
listings, including Listing 3 that was not printed 
because of space constraints; a Visual Basic DLL 
(V/riteEvents.dll) that encapsulates the APIs used to 
write to the event log; a small executable (TestWrite. 
exe) to exercise that DLL (with all source code); and 
a utility program and code (CreateMC.exe) that 
make creating and compiling Message and Category 
files a more rewarding experience 
VS0109JF: "Install Databases a Better Way": the 
sample code files for using SQL-DMO and DTS 
VS0109DW: "Target Multiple Devices": uhe con- 
trol's full source code in both C# and VB.NET, as 
well as several demo ASP.NET pages that show how 
the control can use static XML files and SQL Server 
2000 XML queries 

VS0109CE: C# Explorer: Listing 1 and "Reflections 
on Reflection," the sidebar about the CLR's reflec- 
tion feature 

VS0109WS: Web Services: ail listings, which weren't 
printed due to space constraints; VB.NET and C# 
versions of a serviced component; a Windows Forms 
client; and a Web Service wrapper for the serviced 
component 

VS0109GS: Getting Started: a reusable ActiveX 
DLL that forms the core of the scheduler, a schedul- 
ing test app, and a client app that's controlled with 
command-line parameters 

VS0109DT: Desktop Developer: full code to re- 
create the Applications tab of NT's Task Manager, as 
well as several 16- and 32-bit "suicidal" apps that 
make good test subjects 

VS0109QA: Q&A: a sample showing several ways to 
split color values into their components and a demo 
of a borderless form with a 3-D border 



VS0109EX: Expert XML: the code projects for 
using XmlWriter and Xml Reader and extra code for 
comparing XML documents to find the differences 
VS0109AN: ASP.NET: the complete ASP.NET 
code for the application, consisting of a WebForm 
and a code-behind VB.NET class that performs the 
work of drawing the graphics labels 
VS0109DD: Database Design: script files to build 
the database with its indexes and procedures, a copy 
of the project Stocks database, and the complete table 
layout for the various stock tables 
VS0109BB: Black Belt: the Exception class, accom- 
panying utility functions, a form that tests the class's 
features, and an RTF file containing additional in- 
formation about the class 



Do We Owe You Money? 

If you haven't been compensated for a published tip in Visual Basic Programmer's 
Journal please e-mail us at vsmtips@fawcette.com. Put "payment for" and the issue 
date in the subject line, and include your mailing address in the message body. Also 

indicate whether you d prefer $25, a new Visual Studio A/agita/WsubscripLiull, or an 

extension to an existing subscription (include your mailing label information for the 
latter). We'll process your compensation as soon as possible. — Eds. 
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Internet I Chart FX Client Server I Chart FX Financial I Chart FX Wireless | myChartFX.com | Chart FX for .NET | Pocket Chart FX | Chart FX Real-Time 



which Internet charting so 




mm 




it wt Chart FX? 

Ma's not gonna like that! 



Chart FX Internet is the only charting solution 
specifically designed to work on intricate server 
architectures, such as web farms, or to take full 
advantage of today's most powerful web servers. 
Chart FX Internet has the ability to create interactive 
image maps and drilldown capabilities; and also 
generate ASP, Cold Fusion or client-side code, 
making it the most powerful, yet affordable, solution 
when needing to integrate charts into a commercial 
web site or corporate intranet. The Chart FX family 
of products is the most powerful, easy to integrate, 
interactive charting solution available From the 
royalty-free 32-bit power of Chart FX Client Server, 
to the seamless web integration of Chart FX Internet, 
the incredible range of Chart FX Financial for 
technical analysis, the convenient mobility of 
Chart FX Wireless and Pocket Chart FX, the 
state-of-the-art Chart FX for .NET and Chart FX 
Real-Time and finally, the amazing web services 
at myChartFX.com — the Chart FX family of 
products is unsurpassed. When you want the best 
there's only one choice — Chart FX. Download 
a free trial version at www.5oftvvorerx.com and 
for more information call 561.999.8888. 



Chart FX 



Internet from Software FX 



©2001 Software FX. All rights reserved. Chart FX, Chart FX Client Server. Chart FX 
Internet, Chart FX Financial, myChartFX.com, Chart FX Wireless, Pocket Chart FX 
and Chart FX Real-Time Edition are registered trademarks of Software FX, Inc. 
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CONTROL 

The Comprehensive Text Integration Tool 



New! Now shipping v. 



Bullets & Numbered Lists 

Signed CAB File for Internet Download 

Print Method for Printing from IE, Access & 
FoxPro 

New Table Functions 
Extended C++ Class Library 



Royalty-Free Word Processor Control 

ActiveX (Visual Basic, Delphi, VBScript,..) and 
Class Library (Visual C++) 

Read and Write RTF, HTML, Word 2000, 
ANSI and Unicode 

Run as .exe or in Internet Explorer 

(CAB file included) 

Tables, Headers & Footers, Hyperlinks, 
Bullets, Numbered Lists, Zoom, Page View 

FREE Tech Support 



Virtually all applications can make use of powerful word 
processing functions. TX Text Control gives you that power and 
delivers it in a reusable component form. With TX Text Control, you 
get hands-on access to the most comprehensive set of word 
processing features available in a development toolkit. 



Database Applications 

Text Control can be connected to any type of database, and store 
formatted text as binary data, RTF or HTML. You can store a 
complete document as a record, or load text from a database into 
table cells and macro fields. Typical applications which can be 
created are mail merge, report generators, formatted data entry 
masks, and all types of business apps. where documents are 
created from information stored in a database. 



Office Applications 

With Text Control you can easily create contemporary office 
applications which combine the paper and fax based office world 
with web technologies. Send faxes as email, or emails as fax, 
deploy and run the complete application over the Internet. No more 
setup programs, no more separate address books for mail, fax, and 
email. 

- Use Tables and macro fields for calculations. 

- Exchange .DOC files with MS Word 

- Insert graphics or spreadsheets as OLE objects 



Web Applications 

The included WebApps toolkit gives you all you need to deploy and 
run yourapplication on the Internet: 

-Code-signed CAB file for automated download, no setup required 

- Enhanced printing and print preview functions for Internet Explorer 
-Hyperlinks 

- Create User Controls with Visual Basic 

- Run Text Control in a web page with HTML/VBScript 

- Use with FrontPage, Visual Interdev, Visual Basic, or directly in 
HTML code 



Database 
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Text Control 




Text Control Features 

• ActiveX for VB and Delphi 

• Class Library for Visual C++ 

. File Formats: HTML, RTF, Word 6 to 

2000, ANSI and Unicode 
. Image Formats: TIFF, BMP, JPEG, 

WMF 

• Tables 

• Headers & Footers 

• Bullets & Numbered Lists 

• Text Flow Around Embedded 
Images, OLE Objects & Controls 

• Undo-Redo 

• Transparent Mode 

• Read-only Mode 

• Hyperlinks 

• Macro Fields 

• Connect to Any Type of Database 
. Unlimited File Size (>5MB) 

• Runs in Internet Explorer 

• Drag & Drop 

• Ready-to-Use Toolbars and Dialogs 
. True WYSIWYG Page View 

• Print Preview 

. Zoom 10% - 400% in Steps of 1% 

• Text Color and Background Color 
Adjustable per Character 

• Localized for English, French, 
Spanish, Italian, German and 
Japanese. Can be Translated to 
Other Languages. 

• Optional: Spell Checking with 
VideoSoft VSSpeli 

• Optional: Enhanced Image 
Processing with LEADTOOLS 




OL 



'he Comprehensive Text Integration Tool 



877-898-2875 

30 day money-back guarantee 

To order: visit our website 

or Email: sales@textcontrol.com 



www.textcontrol.com 

VISIT FOR A FREE, TIIN/IE-UIM LIMITED TRIAL VERSION 



First Looks 



UltraSuite: 
Sum of the Parts 



UltraSuite 2.0 brings together in one package the best compo- 
nents of Sheridan Software Systems and ProtoView Develop- 
ment, the companies that merged to form Infragistics. It combines 
the components of the company's UltraGrid, Data Explorer, 
ActiveTreeView, UltraToolBars, and ScheduleX products, along 
with another 16 controls exclusive to UltraSuite. The package can 
help make your interfaces more user-friendly, or it can mock up your 
app to look like Microsoft Office. 

Every developer needs a grid now and then, and UltraGrid is 
becoming one of my favorites. It doesn't beat ComponentOne's 
TrueDBGrid Pro or VSFlexGrid Pro at their specialties, but 
UltraGrid is a great all-purpose grid control. It handles hierarchical 
recordsets with flair for those times when you need to bind to data, 

UltraSuite 2.0 

Infragistics 

Web: www.infragistics.com Phone: 800-231-8588; 609-655-5000 
Price: Starts at S995. 

Quick Facts: Collection of user interface and functional components, bringing 
together the best Infragistics products. 

Pros: Flexible, powerful components; lots of sample apps; sold at a discount 
from individual products. 

Cons: No printed documentation; pricey if you don't use all the components. 




User Interfaces to Die For. UltraGrid 2.0 gives you more flexibility 
in user interface design than you should ever use in a single 
application. But you can now bend VB6 and VC++ applications to 
display what you need. 

and it has more customization features than you'd ever want to use 
in an application. 

UltraToolBars and ScheduleX are two more of my favorites. 
UltraToolBars mimics some of the user interface components of the 
Microsoft applications familiar to your users, and ScheduleX is a set 
of calendar, date, and time-entry controls for any kind of temporal 
data entry. These tools can mimic Microsoft products too, but they 
also give you the flexibility to design any kind of appearance that 
makes sense for your application. 

UltraSuite unleashes impressive power and features in its 
controls, but the programmatic features are what make these 
controls shine. Infragistics faces an uphill battle in making the 
components from the merged companies completely consistent, 
but both Sheridan and ProtoView had a tradition of providing 
object-based features behind most of their controls. In many cases, 
you can elect to work with control properties, events, and meth- 



Turn OLAP Cubes Into 
Interactive Reports 

Crystal Analysis Professional 8 is an online analytic process- 
ing (OLAP) design tool that lets you dig deep into your SQL 
Server database and present statistics in multiple dimensions. If 
you've used 3-D charts in Microsoft Excel, you already know 
about the power of viewing data visually. Crystal Analysis 
Professional (CAP) picks up where Excel leaves off and kicks it 
up a notch. 

You might be asked to design and build several analyses and point 
each one to the appropriate data source, but interpreting the data or 
entire briefing book daily is probably someone else's job. So CAP lets 
you perform the initial setup but allows the end user to manipulate, 
rotate, and reconfigure the views without callingyou backfor a tweak. 

CAP's print documentation provides valuable tutorials that 

Crystal Analysis Professional 8 

Crystal Decisions 

Web: www.crystaldecisions.com Phone: 800-877-2340 
Price: Starts at S395. 

Quick Facts: Report-creation tool for OLAP on SQL Server designed for desktop 
or Web use 

Pros: Powerful and intuitive user interface for creating report files; good tutorial 
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Design Interactive Reports. Crystal Analysis Professional 8 lets you 
create customized and interactive reports based on SQL Server's 
Analysis Services. You can distribute the Crystal Analytic Report (CAR) 
files in XM L format to other users of the desktop version or upload the 
same reports for Web-based browsing through Crystal Enterprise. 

familiarize you with the tool and reporting techniques. If you're a 
visual learner, it has animated online tutorials that demonstrate 
the key steps. With the user assistance, you can create some 
attractive cubes to explore in an hour or two. As you advance, try 
inserting transition buttons that guide users through prepared 
views; you can even add objects that let experienced analysts drill 
down on the data at will. 

CAP is designed to develop desktop reports in Windows and 
manipulate data as you would with Excel. A peek into a Crystal 
Analytic Report (CAR) file with Notepad shows you that the 
software round-trips XML — and when you see XML, Web publish- 
ing isn't far away. Sure enough, you can save your analysis file 
directly to the high-end Crystal Enterprise server for Web distribu- 
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FarPoint's Button Objx 



FarPoint's Calendar Objx 



FarPoint's Input Pro 




» FarPoinrs 

Button Objx 2 

Create fully customized buttons, 
toolbars and custom-shaped 
containers 

FarPoint's Button Objx enhances any 
web or Windows application. Not 
only can you replace the Windows 
button control to create visually enhanced buttons, 
you can create fully customized active buttons and 
toolbars as well as custom-shaped containers. 



> Create active-style buttons with or without 
3D borders 

> Create a toolbar or tool palette 

> Includes a help balloon (tool tip) for displaying 
customized text 




» FarPoinrs 

Calendar Objx 3 

Adding custom calendar and time input to your application has 
never been this easy 

FarPoint's Calendar Objx 3 gives you all the components 
your development team needs to display or select date 
and/or time values in any application. By including a 
calendar control, a clock control, a poster control, and 
a schedule control, Calendar Objx makes it easy to 
incorporate robust calendar or schedule features in 
your program's interface today. 

> Choose from multiple calendar display formats 

> Customize all calendar elements 

> Includes five AutoStyles to help you create 
commonly used calendar looks 




» FarPoint's 

Input Pro 3 

Full-featured edit 
components for precise 
data input 

Easily create professional data- 
entry screens using Input Pro's 
eight custom controls. Take advantage of the six for- 
matted edit controls to quickly validate data and alert 
your user as they enter information or as the appli- 
cation programmatically assigns or edits values. 

> Choose from six edit controls (Currency, 
DateTime, DoubleSingle, Longlnteger, 
Mask, or Text) 

> Create your own appearance or choose from 
predefined styles 

> Includes a Memo control and Boolean control 



» FarPoinrs 

List Pro 3 

The ultimate data 
viewer 

FarPoint's List Pro 
contains the most 
powerful list box and combo box 
development components. These extremely robust 
controls allow you to display up to two billion list 
items, display single records or items on multiple 
rows, merge cell text for easier viewing, search for 
specific list items, or sort list items using unlimited 
keys. 

> Display data in single or multiple columns 

> Merge column cells that contain identical text 

> Choose an automatic search method 




FARPOINT 

TECHNOLOGIES INC 



www. 



fpoint. 



com 




FarPoint's List Pro 



FarPoinrs Tab Pro 



FarPoint's Spread 



T 



AWARD-WINNING COMPONENTS 
FOR THE PROFESSIONAL DEVELOPER 




» FarPoint's 

Tab Pro 3 

Speed, ease of use, and its 
extensive features make this 
the "tab of choice" 

Tab Pro is the easiest and 
quickest way to enhance your 
application's appearance using 
a tab metaphor. Whether taking advantage of its eight 
pre-defined appearance styles or dynamically changing 
the tab's appearance in response to your user, Tab Pro 
gives you the most comprehensive tab feature set to 
customize any application. 

> Choose from eight pre-defined appearance 
styles 

> Design time support for setting pictures, plus 
metafile support 

> Create a book chapter effect by assigning 
multiple pages to one tab 



New Bundles 

» Enterprise Developer Toolbox 
(bundle of all products) 

» Enterprise Database Park 
(Spread, List Pro, Input Pro) 

Purchase your copies today by calling 
800-645-5913 
or download fully functional trial 
versions from our website. 
( www.fpoint.com ] 
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Spread 3.5 
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It's an 
enhanced grid... 

Spread is the best grid to 
use to present and format 
tabular or database infor- 
mation in a format your 
users want. 



> Bind using the most popular data 
sources or populate in unbound 
mode 

> Create a grid with up to 2 billion 
rows by 2 billion columns 

> Provide the most popular data and database 
formats using 1 2 cell types 

> Increase data access speed by using the Virtual 
Data Manager 

> Change the font and background and foreground 
colors of any cell 

> Increased control by validating when 
and what data gets written to the 
database 

It's a spreadsheet... 

Spread is the best spreadsheet to 
use to offer advanced spreadsheet 
functionality your users need. 

> Import and export spreadsheet files in Microsoft Excel 
97/2000 or many other formats 

> Export spreadsheet files as XML or HTML files 

> Use one of 1 05 named functions or create 
user-defined custom functions 

> Sort with up to 256 sort keys 

It's a report writer... 

Spread is the best report writer to use to 
preview and print data in the format your 
users expect. 

> Use the Print Preview control to see how your 
printed spreadsheet will look 

> Print a block of cells, a range of pages, or only the columns and 
rows that contain data 

> Create custom print configurations by specifying 
margins, page orientation, borders, gridlines, colors, and 
shadow effects 

> Print multiple spreadsheets on a single page 

> Add headers and/or footers to your printed pages 





Enterprise Development Components j A nd it's Much More. 



UltraSuite: Sum of the Parts 

ods, or you can delve down into the object 
model for even tighter control. 

In fact, this power overcomes one of the 
usual limitations of such tool suites. Because 
UltraSuite brings together several different 
standalone products — and in this case, two 
different companies' products — each set of 
components is at a different level of matu- 
rity and refinement. But together, they form 
a cohesive whole, a collection of tools that 
can spruce up any application. But be care- 
ful — there is a fine line between attractive, 
colorful apps and those that are garish. 

One of my long-standing peeves with 
Sheridan has been the lack of printed manu- 
als with its products. It's been a while since 
I've looked at any ProtoView products, but 
Infragistics seems to have adopted the no- 
manual philosophy as well. This is a shame, 
because the company produces some of the 
best documentation in the business. It has 
even abandoned Sheridan's practice of in- 
cluding manuals in PDF format. 

UltraSuite's complexity means you'll have 
a learning curve before you use its controls 



effectively, and you'll come across the occa- 
sional rough edge. But Infragistics has done a 
good job positioning this as the suite to beat. 
It's the last user interface package I'll ever 
have to buy. vsm 



Don Kiely is a senior software technologist 
for Third Sector Technologies in Fairbanks, 
Alaska. He has written several books about 
VB and VC++, and he speaks regularly at 
VBITS. Reach himatdonkiely@computer.org. 



Turn OLAP Cubes ... 

tion (see my First Look review of Crystal 
Enterprise 8, "Publish reports on the Web," 
Visual Basic Programmer's Journal June 
2001). CAP includes the Standard (but 
feature-limited) version of Crystal Enter- 
prise and a five concurrent user license, 
which the company proclaims a "$10,000 
value." You can upgrade to Crystal Enter- 
prise Professional, but make sure you check 
the licensing costs carefully — multiple con- 
current licenses can inflate the cost of this 
solution drastically. 

One problem I had was that the software 



acted up on my Windows 2000 Professional 
machine after I installed the Microsoft SQL 
OLAP service, but when I moved opera- 
tions to my Windows 2000 Server, it worked 
fine. In addition, Crystal's screenshots show 
CAR files rendered in a browser, but after 
repeated efforts, I couldn't get Crystal En- 
terprise to transform the pages into Dy- 
namic HTML (DHTML) or serve them up 
to the browser. 

Nevertheless, CAP is a powerful tool for 
data analysis from a desktop and potentially 
through a Web browser. I recommend you 
request an in-house demonstration to en- 
sure that the products work on your system 
and to watch the pricing carefully. The base 
cost is $395, but you'll certainly need expan- 
sion room and concurrent user licenses. And 
of course, this product is a companidn to 
Microsoft SQL Server, which has its own 
price tag. vsm 



Ken Cox is a technical writer and Web appli- 
cations developer in Toronto. Aformer broad- 
cast journalist, Ken is also a Microsoft Most 
Valuable Professional (MVP). Reach Ken at 
kjopc@hotmail.com. 




Desaware, Inc. 



I founded Desaware in 1991 as a Way of offering advanced tools and information to Visual Basic 
programmers. Our flagship product is SpyWorks. which lias now been revised to support feaftires 
useful to VB.NET and C# programmers using Beta 2 of VS.NET. Please v isit our website for 
information on Desaware's other products, including .NET versions of VersionStamper and 
StorageTools. and my new book "Moving to VB .NET: Strategies. Concepts and Code". 



Dan Appleman, Author 
and President of Desaware 



NEW FOR VER. 6.3 

SupportforVB.NET 
Beta 21 

Cross-task subclassing, 
system hooks and 
keyboard hooks now 
supported in VB.NET 
and C#! 
Also available: 

NT Service Toolkit 

Finally, a way to create 
full power NT services 
from Visual Basic 6! 
Download our full 

featured demo dl 
www. desaware.com. 



SpyWorks 6.3 Professional 

New Version! 



ATL Based Controls 

Lightweight, with new fea- 
tures and no dependencies. 

WINSOCK 

VB source code, HTTP & FTP 

Create Control Panel 
Applets in Visual Basic 

Function Exports 

Export functions from 
VB DLLs. 



Implement ANY Interface 

Call any Interface 

Any method, any interface, 
no type library. 

Form Customization 

Scrollbars, Virtual forms, 
Mo use E nte r/Mo use Ex it, 
Tiny Captions and Rollups. 

Windows Hooks 

Intercept messages and 
keys for any window, or 
the entire system. 




VB6 Background Threads 

Create background threads in 
yourVB6 DLL components. 
Ideal for background tasks 
or waiting for system events. 

Total Subclassing 

Professional subscription 

includes three free updates, 
additional controls & source. 

Desaware Inc. 

1100 E. Hamilton Ave. Ste. 4 
Campbell, CA 95008 
tel: (408) 377-4770 
fax: (408) 371-3530 
support@desaware.com 
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Fix a Problem You 
Didn't Know You Had 

X Calls is an intriguing bit of software. It's one of those unique 
packages that defies categorization. To put that into perspective, 
I've spent more time wrestling with how to describe it than I've 
expended with any other product I've reviewed in the past. 

It's distinctive because — if you're like me — you probably never 
thought about the need it addresses. But when you see what it does, 
you wonder why no one took care of it sooner. 

So, what does It do? It's sort of a "micro-middleware" layer that 
gives you a high level of control over the way your code handles 
COM calls. It bills itself as a replacement for the CallByName 
method, but it does quite a bit more than that. As I see it, XCalls 
provides two primary advantages. The first is the ability to exert fine 
control over how your code manages calls — you can give your users 
feedback as the call progresses, you can perform asynchronous calls 

XCalls 

exe IT 

Web: www.exeit.sk/xcalls/default.htm 

Price: Starts at$94.05 through ComponentSource (www.componentsource.com). 
Quick Facts: A beefed-up replacement for the CallByName method. 
Pros: Lets you implement interruptible COM calls; adds a variety of usability 
features. 

Cons: Fairly extensive object model; steep learning curve for more than basic 
CallByName replacement functionality. 





TakeaTour With the Client Example Program. XCalls' client example 
code walks you through a variety of advanced features. XCalls includes 
a built-in progress dialog, and it can deal with different calling scenarios. 
There's a lot to grasp, but the example code helps you digest it. 

(which is nice because your calling code doesn't lock up while you 
wait for another process to complete), and you can cancel a call that's 
executing already. 

The second main benefit is the ability to allow failed calls to 
degrade gracefully. When your code depends on external exec- 
utables — whether they're part of your project, Office applications, 
or someone else's server code on another machine — you're pretty 
much locked into a "wait for an error" scenario. But with XCalls, 
you're no longer captive to a binary succeed/fail option; you can 
code for any imaginable contingency, including custom timeout 
periods, and you can deal with problems on your terms. 

Although XCalls' concept is simple at heart — it replaces built-in 
calling conventions with a flexible, versatile substitute — you need to 
deal with a bit of a learning curve to use its more powerful abilities. 

The object model isn't particularly complex, with only four 
objects — XCallControl, XCallError, XCallProgressDialog, and 



Integrate and Manage 
Your Design and Code 

At the heart of any good software system is good design. But 
developing and documenting it while maintaining the changes 
that evolve in its implementation can be a daunting task. At times, 
reverse-engineering legacy code and figuring out what others have 
written can be even more challenging. Together ControlCenter 
provides an integrated approach to tackling these problems. 

At first glance, Together ControlCenter might resemble just 
another Unified Modeling Language (UML) diagramming tool. 
But when you get beneath the surface, there's much more to it. It's 
really an entire development environment where you can perform 
most of your development tasks if you choose. It takes some 



Together ControlCenter 5.02 
TogetherSoft Corp. 

Web: www.togethersoft.com Phone: 919-833-5550 
Price: Contact vendor. 

Quick Facts: UML design and diagramming; forward- and reverse-engineering 
from C++, Java, and CORBA I0L code; development tool integration in a single 
environment. 

Pros: Smooth diagramming interaction; integrated project management; ex- 
cellent forward- and reverse-engineering of code to and from diagrams; good 
documentation generation. 

-face response; Java user interface 
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Model Your Complexities. Using Together ControlCenter's reverse- 
engineering features, you can create a complex class or sequence 
diagram automatically from existing code in a snap. Together 
ControlCenter keeps you informed of its progress through a message 
pane while it parses code, and it forward-engineers code from class 
diagrams while you model. 

getting used to and you need time to configure it to integrate with 
your existing development tools. But it's similar to Visual Studio 
in its layout, so you can configure Together ControlCenter to 
launch other development tools directly from one development 
environment. 

This tool's strengths are its smooth diagramming, code, and 
documentation-generation capabilities. The user interface for draw- 
ing UML diagrams has a clean and snappy response, and you can 
create a variety of model types, business process models, and entity- 
relationship diagrams. The diagramming tools are all smooth and 
easy to use, and they include several handy productivity tools — such 
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Time for some serious 

KeyStone offers the most in-depth 
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Learning 



Java 'GUI Pro I 





Java- GUI 
Programming 

Build user interlaces using Swing 
Java Foundation Classes (JFC). 



4 CDs 

Single-User List Price $699.00 



$599 



95 



Java'JDBC & Servlet 
Programming 

Provides you a strong foundation in 
web development databases, SQL, 
HTML and Servlets. 



4 CDs 



Single-User List Price $699.00 



$599 



95 



© [opinihi HI KeySfflne leaimno Sisiems Com. lows®, Microsoft®. Bra®, led Hal®, Java and all Java-based marks ®, and iheir plans, aia tridenrts and/or mistered uademarks ol (tita Ling Systems Corp and Lotus. Minos* Cisco, lied Bat aid Soo Microsystems. Ino in tne U S aid other countries ratciiitli 
Discounts aprjli leiStont [Is, Mas ml Wis mil Prices aie sunien to clange MM notice. 



computer training 

self-paced training available. 



Visual Basic* 6.0 

Learn API, ActiveX Controls, 
automation programming and 
much more. 



17 CDs 

Single-User List Price $1 869.00 



$1199' 



195 




Java" 2.0 

Learn Java architecture, object 
creation, multi-threading 
capabilities, applets, & servlets. 

8 CDs $599' 

Single-User List Price $879.00 
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SQL Server* 2000 

The entire course prepares 
you for Exams 70-228 and 
70-229. 



11 CDS 

Single-User Ust Price $1 299.00 



$1099 



195 




Windows' 2000 

Includes the learning courses 
related to exams 70-210, 
70-215, 70-216, and 70-217. 



25 CDs 

Single-User List Price $2750.00 



$1799' 



195 



XML 




XML 

Learn XML markup, 
content modeling, XML 
entities, scripting, dynamic 
sites and documents. 

5 CDs $399 95 

Single-User List Price $549.00 




Intro to Java" 

Become proficient in the Java 
programming language. Create 
applets and applications. 



4 CDs $599 

Single-User List Price $699.95 
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HTML & DHTML 

Learn page attributes, 
legends, tables, padding 
attributes, HTML & DHTML 
structure & hyperlinks. 



6 CDs, 3 Videos 

Single-User Ust Price $989.00 



$699 



■95 




Oracle* 8iR2 

This course will cover many 
of the complex topics 
needed for certification. 



5 CDs 

Singie-User List Price $999.00 



$899 95 




Over 1200 Titles Available 



) Please call for multi-user discounts and pricing. Prices shown are for single-user training only. 



When it comes to self-paced computer training, no other company comes close. KeyStone 
packs the maximum amount of information in every course, making it easier to learn 
and retain. Exclusive KeyNotes keep it concise and come in a format you can review 
whenever you would like. With over 1200 self-paced training courses available, 
KeyStone Learning Systems has the learning course you need. 



To Order or Receive A Free Catalog 

1.800.349.5761 

www.keystonelearning.com 



First Looks 



Fix a Problem You Didn't ... 

XCallProgressData — that handle calling, 
monitoring, and other maintenance issues. 
But these objects are richly endowed with a 
variety of methods and properties. And be- 
cause of the package's flexible runtime call- 
handling features (such as the ability to 
accept named parameters) and ability to 
store executed call results, using the package 
effectively entails a nontrivial amount of 
learning effort. But XCalls does include an 
extensive help file that covers its flexible 
built-in progress dialog, animations, and 
techniques to create custom dialogs. 

XCalls is worth a try, in my opinion, 
because of the degree of usability you'll be 
able to implement in your projects — usabil- 
ity you could not hope to emulate without 
the product. You can download a "nag- 
screened" evaluation copy and see how it 
works, vswi 



Ron Schwarz lurks in rural Michigan. When 
he's not digging out of the mountain of e-mail 



in his inbox, he maintains his sanity by restor- 
ing classic cameras. He welcomes your com- 
ments at www.clubvb.com. 

Integrate and Manage ... 

as a Find tool to locate items in a large 
diagram — to ease your diagramming tasks. 

Its forward-engineering capabilities are 
slick, too. If you're creating a class diagram, 
the tool creates and updates the corre- 
sponding code dynamically in an editing 
pane that you can choose to display or hide. 
Your choices for code generation are C++, 
Java, or CORBA IDL. The ability to see 
your code take shape dynamically as you 
draw can help formulate your thoughts 
considerably if you're accustomed to being 
close to the code. 

Together ControlCenter's reverse- 
engineering capabilities are also powerful. 
All you need to do is add the folder that an 
existing project resides in, and the Together 
engine parses the source code and adds all 
the classes to your model. You can then use 



these classes to create new diagrams to de- 
pict the code, and as you make changes to 
the classes in the UML diagrams, the engine 
updates the source code appropriately. 

Together ControlCenter does have a Java 
user interface, so unfortunately, starting up 
takes awhile and the tool has some addi- 
tional latency associated with menu and 
control interactions you wouldn't see in a 
native Windows GUI app. I also experi- 
enced a few user interface instabilities now 
and then, but these nuisances are rare and 
always disappear with a second try. 

Together ControlCenter is a complex 
and powerful tool. Its integrated diagram 
and code-management capabilities far out- 
weigh its few shortcomings, and it'll make 
you a better and more productive designer 
in no time, usm 



Brian Noyes is a senior software engineer 
with Digital Access Corp. He's an MCSD with 
nine years of software development, project 
management, and test and evaluation experi- 
ence. E-mail him at bnoyes@domeworks.com. 
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Microsoft* - - 

FrontPage 8 IS^I 
20021 

The fast, easy way to create 
and manage professional 
Web sites! 

• Generates HTML code. 

• Easily add E-commerce 
functionality to your site. 

• Automatically updated Web 
content (MSNBC, Expedia) 

• 67 Customizable Themes 
updated for 2002! 



[Microsoft* tl 

Exchange2000 

Server 

Ideal platform for business 
critical messaging. Powerful 
collaborative features! 

• Keep your company's staff 
up-to-date in real time! 

• Unified management of all 
messaging, collaboration and 
network resources. 

■ Greater efficiency and power 
by unifying information flow. 



Microsoft 

SharePoinf 

—Team Services — 

A team Web site solution 
designed to improve the way 
a team manages information! | 

• Seamless communication 
and efficient collaboration. 

• Document Libraries. 

• Discussion Boards. 

• Customize from a Browser. 

• Customize with Microsoft 8 
FrontPage* Version 2002. 



Micro soft' . The Next Generation Internet... 

1^1 /_Jr| < - >ur research and development technicians have been working with NET since its 



!ing this new and innovative Microsoft platform! 



kVA VIVA 111 



•■ '-JiSi 

ivironmenV 



iNNER 




30 



Visual Studio Magazine • September 2001 • 



www.vcdj.com 



Herd about COW? 




Introducing the fastest way to build sophisticated 



database applications for the Web. Featuring dynamic server pages, and simple-to-use 
yet powerful object technology. With the world's fastest and most scalable Web 
database, Cache, already built in. Compatible with other popular databases and leading 
Web design tools. 

InterSystems f 

£ CACHE. 

Download a fully-functional COW, or request it on CD, free at: www.CACHE-COW.com 

Or call 1-800-753-2571 

© 2001 InterSystems Corporation. All rights reserved. InterSystems Cache is a registered trademark of InterSystems Corporation. 



Editor's Note: Please send product informa- 
tion to Product Listings Editor, c/o Fawcette 
Technical Publications, 209 Hamilton Avenue, 
Palo Alto, CA 94301-2500; fax: 650-853-0230: 
e-mail: vsmedit@fawcette.com. 



AppForge 

AppForge software lets you create applica- 
tions for PDAs and Palm OS devices using Vi- 
sual Basic 6.0. A PDB library provides methods 
to manipulate Palm OS databases, a graphic 
viewer/converter converts BMP files into an 
AppForge format, and an extensibility library 
allows AppForge applicationstocailother Palm 
applications, shared libraries, and extensions. 
Other features include TrueType font support, a 
Palm OS extended functions library, and wire- 
less Internet support. Starts at $69. 
AppForge Inc. 
Phone: 678-686-9000 
Web: www.appforge.com 

CopyWiz 1.0 

CopyWiz 1.0 lets you copy and rename exist- 
ing projects easily, create template projects 
on which to base new projects, and fix up 
directories and filenames in projects. It also 
includes path analysis capabilitiesto change 
absolute paths to their correct relative paths 
and to update relative paths to their minimal 
required value. $29.95. 
Kinook Software 
Phone: 719-599-0442 
Web: www.kinook.com 

Dexter 1.0 

Dexter 1.0 is an add-in that provides auto- 
matic code completion for all Microsoft de- 
velopment environments, including Visual 
C++, Visual Basic, VBA, Visual InterDev, Vi- 
sual J++, and .NET. The program recognizes 
and completes language statements auto- 
matically. You can configure it and tailor it to 
suit any programming style or desired layout. 
It requires Windows 95/98/Me/NT/2000, a 
Pentium 900-MHz or faster, and 1 MB of free 
disk space. $30. 
NilgiriHouse.com 
Web: www.nilgirihouse.com 

eMPower Express 

eMPower Express is a Web content publish- 
ing tool for dynamic Web sites running on 
Active Server Pages or ColdFusion platforms. 
Itallowsyouto upload any kind of file, graphic, 
or data and view or restore any previously 
published version of a content block. Other 
features include a virtual staging server, 
Microsoft SQL integration, document check- 
in/check-out with color-coded content 
blocks, and the ability to add approval per- 
missions on a per-user basis. Starts at $499. 
Ektron Inc. 
Phone: 603-594-0249 
Web: www.ektron.com 

Genitor OCS 

GenitorObjectConstruction Suite (OCSI helps 
you construct, document, and reuse C/C++ 
objects. The program helps you above the file 
level, letting you work with objects instead. It 
also provides an infrastructure for object re- 
use so you can quickly locate, analyze, and 
understand work tbatothers comp/eted. Fea- 
tures include rapid object development, dy- 



namic documentation, workgroup program- 
ming, auxiliary file generation, and legacy 
code engineering. $845. 
StarBase Corp. 

Phone: 888-STAR 700; 714-445-4400 
Web: www.starbase.com 

J-lntegra 

J-lntegra is a pure Java-DCOM implementa- 
tion offering integration between Java cli- 
ents and Microsoft COM components. You 
can access COM components from Java as 
though they were Java objects, and Java 
objects from COM as though they were COM 
components. You can use it with any JVM 
running on any platform. The program fea- 
tures a high-speed native modefor Windows 
platforms, and it provides COM/Java APIs to 
products and access to Enterprise JavaBeans 
from ASPs. Contact for pricing. 
Intrinsyc 

Phone: 800-474-7644; 604-801-6461 
Web: www.intrinsyc.com 

Objective Chart for XML 

Objective Chart for XML streams XML into 
VC++ appsfor display in extensive and flexible 
chart components. The program contains an 
XML persistence mechanism that letyou seri- 
alize charts in an XMLformat. You can display 
data in many different graphical styles and 
objects. By streaming raw XML over the 
Internet to Visual C++ applications, the client 
device populates and renders advanced 2-D/ 
3-D graphs. Contact vendor for pricing. 
Rogue Wave Software 
Phone: 800-924-4223; 303-473-9118 
Web: www.stingray.com 

Objective Grid for XML 

Objective Grid for XML lets you use XML 
within applications. The program streams 
XML into VC++ apps for display in an exten- 
sive and flexible grid component. You can 
write and read Objective Grid as XML and 
convert its XML format into any other format 
(or vice versa) using XSL stylesheets. You 
can build preadsheet applications to commu- 
nicate over the Internet using XML. Contact 
vendor for pricing. 
Rogue Wave Software 
Phone: 800-924-4223; 303-473-9118 
Web: www.stingray.com 

SoftArtisans P0P3 

SoftArtisans P0P3 is a Post Office Protocol 
(POP) client Web control for Microsoft .NET. 
The program is written in C# and lets Web 
developers write customized P0P3 client 
applications in the Microsoft .NET Frame- 
work. You can retrieve, read, store, or delete 
mail in private mailboxes. It provides a new 
method for client machines to access mail 
from a server dynamically. Other features 
include debugging, error handling through 
exception handling, RFC 1939 compliance, 
and extensive utilization of the NET Class 
Library. Free. 
SoftArtisans Inc. 

Phone: 877-SOFTART; 617-738-0777 
Web: www.softartisans.com 

SoftArtisans TreeView 

SoftAuisans TreeView is a Microsoft NET 
Framework control designed to provide easy 



navigation for Microsoft .NET Web sites. You 
can expand and collapse tree nodes in hier- 
archical, menu-based, or tabular views dy- 
namically. It also lets you customize graphi- 
cal and XML representations. Additional fea- 
tures include customizable rendering options 
and layout, support for data binding, and the 
use of rich DHTML. Free. 
SoftArtisans 

Phone: 877-SOFTART; 617-738-0777 
Web: www.softartisans.com 

SourcePro C++ 

SourcePro C++ is a suite of four components 
designed to deploy applications on a variety 
of hardware platforms and databases. 
SourcePro Core contains fundamental com- 
ponents for C++ programming. Source Pro 
DB allows you to write programs that are 
reusable with databases from various ven- 
dors, freeing you from having to understand 
many of the details associated with a particu- 
lar database vendor's API. Source Pro Net 
creates object-oriented networking applica- 
tions, Internet-enabled applications, and se- 
cure networking applications, and it simpli- 
fies development by handling the granular 
details. Source Pro Analysis contains a wide 
range of C++ classes used to solve special- 
ized mathematical problems in business and 
research. Contact for pricing. 
Rogue Wave Software 
Phone: 888-442-9641; 303-473-9118 
Web: www.roguewave.com 

uiRAD 1.0 

uiRAD 1.0 provides RAD approach to com- 
mon field-formatting and validation require- 
ments. The program performsfield-level vali- 
dation and formatting, eliminating repetitious 
code in each code's events. It also offers a 
rule-based control resize and positioning 
engine. $29. 
vbRAD 

Web: www.vbrad.com 




Advisor 2.1 

Advisor 2.1 is an architectural management 
tool for complex C++ applications. The pro- 
gram scans C++ source code and creates 
architectural models and HTMLclass reports. 
It measures classes against object-oriented 
design standards. You scan all the source 
files that make up the "code base" for one or 
many applications, then the program creates 
model and management reports that expose 
the invisible underlying structure of the appli- 
cations. Version 2.1 includes user interface 
enhancements and has been extended to 
work with extremely large C++ projects. Con- 
tact vendor for pricing. 
ObjectQuest Software 
Phone: 770-932-8642 
Web: www.object-quest.com 

C++Test 1.2 

C++Test 1.2 is a unit-testing tool that per- 
forms tests on a class automatically as soon 
as you compile it— without the need to inte- 
grate it into a larger project. It performs class 
functionality testing, regression testing, and 
class construction testing. Version 1.2 in- 



cludes a more flexible and convenienttesting 
environment, improved exception handling, 
customizable object initialization options, and 
a new test case editor and test result viewer. 
Contact for pricing. 
ParaSoft Corp. 

Phone: 888-305-0041; 626-305-0041 
Web: www.parasoft.com 

lnsure++ 6.0 

lnsure++ 6.0 is an automatic runtime error- 
detection tool for C/C++ development. The 
program offers two modes of error detection: 
its Source Code Instrumentation technology, 
and Chaperon, a newtechnology designed to 
provide a check of noninstrumented ex- 
ecutables.You can use Chaperonthroughout 
the development cycle to locate problematic 
areas, while Source Code Instrumentation 
provides a more detailed code. You can 
choose between error detection modes, de- 
pending on development schedules and de- 
sired depth of analysis. Contact for pricing. 
ParaSoft Corp. 

Phone: 888-305-0041; 626-305-0041 
Web: www.parasoft.com 

THBImage 4.0 

THBImage 4.0 is an ActiveX control that pro- 
vides an alternative to the standard Visual 
Basic or Visual C++ Image and PictureBox 
controls. It displays an image and offers all 
ways to align and stretch the image with the 
ability to keep the aspect ratio. It lets you 
create two-color gradients or extended gradi- 
ents. It also offers the ability to scroll, zoom, 
and move a picture. Version 4.0 includes 
databinding capabilitiesand the abilityto read/ 
write all common raster image formats. Sup- 
ports Visual Basic, VC++, and Access. $99. 
THBComponentware 
Phone:+385-21-380770 
Web: www.thb.nu 

UftraGrid 2.0 

UltraGrid 2.0 is a grid-specific software tool 
optimized for OLE DB technology. The 
program's user interfaces are designed to 
make navigating through complex data struc- 
tures easier. It's OLE DB-bound for easy con- 
nectivity to all major databases. It also offers 
cell, row, and header transparency/translu- 
cency, built-in masked editing, automatic or 
manual multicolumn sorting of data, and 
developer-controlled multilevel display and 
behavior attributes. New features include 
printing and print-preview capabilities, data 
formatting, and the ability to store multiple 
layouts. Starts at $395. 
Infragistics Corp. 
Phone: 800-231-8588; 609-655-5000 
Web: www.infragistics.com 

VB-Build 2.6 

VB-Build 2.6 lets you compile Visual Basic 
components. The program fixes references 
to ActiveX components, checks the proper- 
ties of objects, and creates Microsoft Trans- 
action Server packages. Version 2.6 enables 
efficient management of compatibility breaks 
in components and includes more script in 
the script library. $149. 
VB-Build 

Phone: +46522650024 
Web: www.vb-build.com 
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Kitchen sink NOT included... 




Active Reports 2.0 is an upgrade to our best-selling reporting component. Data Dynamics offers Active Reports 2.0 
in two editions to suit your development needs. Both editions build on the power and ease of ActiveReports 1 .0 and add 
many new features and enhancements based on your feedback. 

Active Reports 2.0 Standard Edition now supports distributable XML report layouts, Active Scripting (VBScript/ JScript) 
events and expressions and XML data sources. Active Reports 2.0 Professional Edition adds a royalty-free customizable 
end-user report designer control. Now your users can experience the power of ActiveReports within your applications. 

CSS Styles 
Report Explorer 

ActiveX Host 

Rich Text Control 
Subreport Control 
XML Schema Tree 

ADO, DA0, RD0 and XML 



Lightweight Viewer ■ 
Table of Contents • 



Splitter and Thumbnails ■ 



Syntax-highlighting Editor - 




Data Access 



Supports DAO, RDO, ADO. 

New! Support for XML data sources and XPath, XSL 
expressions. 

Supports unbound data from arrays, collections and 
older data providers. 

Binds to recordsets and resultsets for maximum flexi- 
bility and connection efficiency. 



Architecture 



Full runtime access to objects, data sources and bind- 
ing, ability to add controls at runtime to modify the 
report behavior. 

Full control over printer jobs, properties and output 
devices. 

Hosts ActiveX components and OLE Objects. 



Performance 



Multi-threaded scalable engine. 
Fast response time. 

PRO! Report Caching service for fast web perform- 



Design Environment 



Easy to use Office-like designer environment. 

New! Access Reports import wizard. 

New! Crystal Reports import wizard. 

New! VBScript and JScript events and expressions 
and a built-in syntax-highlighting script editor. 

New! ActiveReports 1 .0 upsizer. 

Includes data bound text, checkbox, image, OLE 
objects, rich text and subreports. 

ActiveX controls host. Use 3rd party controls or your 
own custom controls in your reports. 

New! Barcode control. 

New! Report bookmark and internet hyperlinks. 

New! Controls Style property editor based on stan- 
dard Cascaded Stylesheets (CSS) syntax. 

PRO! Royalty-free end-user report designer control. 



Deployment 



• Reports can be compiled for maximum security and 



New! Report layouts can be distributed as XML-based 
report layout (RPX) files (application-host independent). 

Enhanced! Java viewer based on JDK 1 .3 with print- 
ing support. 

New! TIFF export in addition to Text, RTF, Excel, PDF 
and HTML export filters. 

Enhanced! PDF export supports table of contents 
bookmarks and embedded fonts. 



ActiveX Viewer 



New! Multipage thumbnails. 
New! Split views. 
New! Ruler. 
New! Text search. 
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Pricing 



Introductory pricing (expires July 31st): 

• Standard Edition: $399 

• Professional Edition-. $999* 
'(includes Royalty-free Report Designer) 



www. datadynamics.com 
614-895-3142 Fax 899-2943 



DATA 



DYNAMICS 



Download Free Evaluation Copy 
from our website! 



Planning Developing Integrating Testing Implementing Managing 



Staffing 





• Source code analysis 

Automatic 
error detection 



Performance profiling 

Code coverage 

Automatic runtime 
error handling 



Visual Basic is changing. Compuware can help. 



DevPartner for Visual Basic analyzes Visual Basic source code and 
automatically recommends the changes you should make to ensure 
future development projects are compatible with Visual Basic.NET. 
You receive vital information about slow code, performance 
bottlenecks and code coverage to keep application development 
on time and on track. 

Request your FREE "Moving from Visual Basic 6 to VB.NET" 
white paper today at compuware.com/numega, 
or call 1-800-468-6342. 



compciware/ 



Manage Sales 
Performance 

SparkTech Egypt has helped commercial banking in the Middle 
East. The company developed an enterprise-reporting system 
using Visual Basic 6.0 and SQL Server 7.0 for Citibank Egypt to 
manage the sales function of its consumer banking division. The 
system tracks Citibank employees' direct and telephone sales perfor- 
mance to determine the best ways to sell its variety of banking 
products, including loans and credit cards. 

Managers in the direct sales department use the system to set sales 
targets for each product sold, evaluate sales totals in reports they can 
generate in any time increment, and compare the performance of 
their sales representatives. Managers of the telephone sales depart- 
ment can perform the same functions, and they can also use a 
customer relations management application that helps telephone 
representatives manage daily activities and information such as calls 
to make, sales scripts to read, and customer histories. 

Citibank managers can track individual performance through a 
point-based system based on the functions sales associates perform 
and their individual sales numbers. This point tally helps distribute 
commissions and commendations to the highest performers, and it 
helps Citibank executives determine where the company stands 
relative to its goals. In addition, the system links job petformance 

Hotel Data on 
Demand 

Hotel and restaurant managers and corporate executives need a 
lot of up-to-date information at their fingertips to keep their 
chains running smoothly — even if they're on the road or at a remote 
site. With Gainesville, Ga.-based M3 Hotel Accounting's AccKnowl- 
edge and InnQuire applications, that information's much easier to 
come by. 

In the not-so-old days, data entry was done on DOS accounting 
software, and managers relied on faxes or phone calls to get news 
such as the number of rooms sold that night, each day's revenue, and 
restaurant sales. M3 has changed that model with AccKnowledge, 
which is in use at approximately 300 hotels and restaurants. The 
business's general manager enters a report daily into the AccKnowl- 
edge accounting and data collection system. Managers and execu- 
tives can then view this information — along with stats for other 
hotels or restaurants in their chain — over the Web through the 
InnQuire management reporting module. Allan Duarte, M3's 
director of information technology, notes that clients are now 
"getting a lot of important information on a timely basis that they 
never got before." 

Duarte worked with senior software developers Chris Rickwood 
and Terry Porter over an 18-month period to create the applica- 
tions. They used Visual Basic 6.0 and SQL Server 7.0 to create 
AccKnowledge, and SQL Server 7.0, Dynamic HTML, Active 





For more information, contact Hany Naguib at hynaguib@sparktech 
egypt.com or Ramy Habashy at habashy@sparktechegypt.com, or visit 
www.sparktechegypt.com. 

results directly to Citibank's finance and human resources depart- 
ments, which, if using three separate systems, could be quite costly. 

The system comprises four modules: a SQL database application 
that stores company information; a data-entry app that has a self- 
building dictionary; a user-friendly telephone sales module that 
accommodates the Arabic language; and a reporting module that 
churns out individual and company-wide sales reports. A team of 
eight developers, led by Ramy Habashy and Hany Naguib, took two 
years to develop the system's seven 600K EXE files. In addition to 
VB6 and SQL Server 7.0, the team used Active Data Objects 
(ADO) and Crystal Reports by Crystal Decisions (formerly Seagate 
Software) to complete the project. 

Naguib says the company plans to migrate the system to Visual 
Studio.NET. Incorporating it into the .NET environment, he 
adds, is necessary because customers will eventually want to use 
the system over the Internet and with other components such as 
BizTalk. — Nick Fuentes 




You can reach Allan Duarte at allan@m3as.com, or visit the M3 Hotel 
Accounting Web site at www.m3as.com. 

Server Pages (ASP), and VBScript for InnQuire. AccKnowledge 
contains 33 cusrom OCX modules — one for each function, such as 
financial reports and budgeting. Each OCX loads dynamically, and 
adding code or updating one OCX doesn't affect the others. The 
developers made heavy use of classes: AccKnowledge contains more 
than 90 class objects. M3 also provides the applications in an 
Application Service Provider format; both AccKnowledge and 
InnQuire are offered as a service with a monthly fee. 

Although it has no plans to upgrade the app to Visual Studio. NET, 
in the future M3 does intend to interface with payroll and human 
resource applications. It also plans to expand AccKnowledge and 
InnQuire's target market to other multiunit businesses, such as 
apartment rental management. — Susannah Pfalzer 

To submit proposals for VS All-Stars, send an e-mail to vsmedit® 
fawcette.com. 
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Write to the NT 
Event Logs 



□ VB.NET □ C# 

□ SQLServer □ XML 

□ ASP.NET gfVB6 
Other 

VB5 

Windows NT 4.0, 
Windows 2000, or Whistler 
(beta when written) 

C++ or the Platform SDK 
(for MC.exe) 




■ Download the Platform 
SDK from 

www.microsoft.com/ 

msdownload/platformsdk/ 

setuplauncher.asp 

•Windows Programming, 
"Publicize Your Events," by 
L.J. Johnson [Visual Basic 
Programmer's Journal 
September 1996] 

•Windows Programming, 
"NT Events are a Terrible 
Thing to Waste," by L.J. 
Johnson [Visual Basic 
Programmer's Journal 
March 1996] '■ 

•"HOWTO: Troubleshooting 
the 'Event Message Not 
Found' Message" 
(Q166902): http://support. 
microsoft.com/support/kb/ 
a rti c I e s/q 1 66/9/02. a s p 

• Windows NT Event Logging 
by James D. Murray 
[O'Reilly and Associates, 
1998, ISBN: 1565925149] 

• "The NT EventLog, Part 1" 
& "The NT EventLog, Part 
2" by Richard Grimes 
[Visual C++ Developers 
Journal April & May 1998] 

36 



Take full control of writing to the NT event 
logs, and create the message and category 
files you need. 

by L.J. Johnson 

Creating event log messages is a necessity for any nontrivial application 
running on the NT platform. Not only is the event log Microsoft's recom- 
mended method for capturing warnings and errors, but many vendors have 
embraced it, and an active tools market helps you capture and analyze the event 
log information across multiple computers and domains. Unfortunately, work- 
ing with the event log isn't as easy as it could be. In this article, I'll show you how 
to make writing to the event log a relatively painless experience. 



The event logs are operating system repositories 
that let your applications record event information. 
You can use these records to do a few things, such as 
troubleshoot problems and audit your system access. 
The event logs are a common, centralized repository 
for this type of information, and you can access them 
from other machines on the network easily (and just 
as easily protect them with standard NT security). 

In 1996, I wrote two articles for Visual Basic 
Programmer's Journal on reading and writing to the 
NT event log with the then-current Visual Basic 4.0 
(see Resources). Although the code still works and 
converts without problems into VB6, it's badly dated 
and in need of refactoring. In addition, the code 
doesn't handle multiple logs or categories. Most 
importantly, I didn't clearly explain the method I 
presented to create the message files (by the number 
of e-mails I received) and it required Visual C++ to 
compile the message files. The code for this article 
solves all these problems and more. 

VB's built-in method to write to the event log 
(App.LogEvent) is rather lame and suffers from several 
limitations. App.LogEvent doesn't work from the 
IDE, the Source entry shown in the NT Event Viewer 
applet shows "VBRuntime" for all events using 



Event Properties 



Event | 



5/5/2001 

16:57 

Error 




Source TestWrrteEvenls_Appirce 
Category Category 3 
Event©. 
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Description. 



You can put anything you want here, and ir wrl! be used as the single 
replaceable parameter m the event log 



Da!a (* gy 



0000: 54 00 68 00 69 00 73 00 

0008: 20 00 69 00 73 00 20 00 

0010: 73 00 S £ 00 6d 00 65 00 

0018: 20 00 62 00 €9 00 6a 00 

0020: 61 00 72 00 79 00 20 00 

0028: 64 00 61 00 74 00 61 00 



Figure 1 Your Goal: A Clean Event Log Entry. 

Create a clean event log entry complete with a 
description, binary data, an EventID not enclosed in 
brackets, and a Category entry. Writing to the event 
log isn't a problem, but writing all the information 
(with no error messages) is more problematic. 
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App.LogEvent, and you can't specify an EventID or Category. In 
addition, you can't include binary data (in the bottom section of the 
detail dialog under "Data"), the user is listed as "N/A," and the 
"Description" section includes fixed information you might not want 
to include and can't eliminate. In other words, the App.LogEvent 
probably isn't sufficient for professional applications. 

Actually, writing to the event log is a rather simple, one-API call: 

Private Declare Function ReportEvent _ 

Lib "advapi32" Alias "ReportEventA" (ByVal _ 
hEventLog As Long. ByVal wType As Long, 
ByVal wCategory As Long. ByVal dwEventID As Long. _ 
ByVal IpUserSid As Long, ByVal wNumStrings As Long, _ 
ByVal dwDataSize As Long, IpStrings As Any, _ 
IpRawData As Any) As Long 

The problem is all the setup work you need to do before making this 
simple call. 

Take Control of the Event Log 

I'll show you how to create the necessary Message (and optional 
Category) files through a simple UI in a semiautomated way, then 
compile them with a batch file created by the UI without having 
C++ installed. I'll also demonstrate how to create a component 
(ActiveX DLL) to encapsulate writing to any of the NT event logs 
(except the Security logs) , including the additional logs available on 
Windows 2000 or later. You can include binary data and a category 
optionally. The component includes the user's name, and you have 
complete control over the data written to the description section of 
the log event and the EventID (see Figure 1). 

The Description field for an event log event is based upon informa- 
tion retrieved from a resource file. Microsoft decided that event logs 
should support event reporting in the local system's language (see the 



sidebar, "Why It's the Compiler From Hell"), and it accomplished this 
goal by using resource executable files (DLLs or EXEs), each of which 
include a message resource (resource type 1 1 for you C++ types). 
You can create the message resource in a text editor such as 



Create Message & Categor 



MessageldTypedef=DWORD 

LanguageNames=( 
English=0x409:MSG00409 

) 

SeverityNames-(Success=OxO:STATUS_SEVERITY_SUCCESS 

lnforma1ional=0x1:STATUS_SEVERITY_INFORMATIONAL 
Warning=0x2:STATUS_SEVERITY_WARNING 
ErroM)x3:STATUS SEVERITY ERROR 



FacilityNames=( 
System-OxOFF 
Application-OxO 
) 

Messageld=0x1 

Severity-Informational 

Facility-Application 

SymbolicName-MSGJ01 

Language-English 

%1 



Messageld-0x2 
Messages 

New Message Fie 



- Categories 

New £ategoty File 



New item 



Newl|em 




Figure 2 Automate the Message File. Creating the Message or 
Category message file (*.MC) and compiling it correctly is 
confusing, especially for non-C++ programmers. The utility 
included in the sample code makes this simple, with color-coded 
*.MC file creation and *.BAT files to compile the DLLs (without 
even having C++ installed). 



Why It's the Compiler From Hell 



Using the Message Compiler (MC.exe) to create the Message and 
Category files is a real pain. And using the Message and Category 
files for both reading and writing to the NT event logs is also 
annoying. So why did Microsoft choose to add this level of 
indirection? The answer: multiple language support. Using the 
Message and Category files also helps keep the logs small, 
because the text from these two files isn't stored in the event log 
itself; rather, it is resolved when you view the log item. Although 
CreateMC.exe doesn't support creating multiple language strings 
for the resource files (it defaults to English), it's simple to add that 
functionality to the utility. 

It doesn't do any good to report an event for the system 
administrator (or user) if the message isn't in a language the user/ 
admin understands. By using the compiled resource files (with 
message strings included for each language of interest), the API can 
reformat the final message using the system's local language. Note 
that it doesn't translatethe message — it merely chooses the correct 
(included) language string to use, based on the currently logged-on 
user's regional settings. For example, you could use this code: 

MessageldTypeDef - DWORD 



Language Names=( 

Er,glish=0x409:M5G00409 
Spanish=0x40A:MSG0040A 
Ital ian-0x410:HSG0041O 

) 

MessageID=2100 
Symbol icName=MSG_2100 
Language-Engl ish 

The file, %1, could not be opened -- %2 
Language=Spani sh 



Each message can contain up to 99 insertion strings (%1 to 
%99). In Windows 2000 and later, you can write a URL to the end 
of the message that points to some related online help material. 
The URL must be a fully qualified DNS hostname. 

Microsoft's choice wasn't just gratuitous complexity after all — 
it actually serves a useful purpose. You'll see no benefits if you're 
writing an English-only application, but for more global apps, the 
pain will probably seem a small price to pay. 
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Notepad. The Message Compiler (MC.exe) 
creates a *.BIN, *.RC, and ".II file. The 
Resource Compiler (RC.exe) then creates 
the compiled resource file (*.RES). Finally, 
the linker (Link.exe) compiles that resource 
file into a standard (non-OLE) DLL. Even 
though early articles from Microsoft sug- 
gest you need a stub DLL as an entry point, 
you actually don't. VB includes Link.exe, 



and RC.exe is available on VB's installation 
disk under the ..\Tools directory. The 
MC.exe doesn't come with the VB6-only 
install, but you can get it by downloading 
the Platform SDK (see Resources). Note 
that these DLL files are standard DLLs, not 
ActiveX components, so you don't need to 
register them through RegSvr32.exe. They 
do need their own specialized registration, 



but I'll cover that detail later. 

Creating the message resource files can be 
somewhat confusing, so I've created a simple, 
standalone UI called CreateMC.exe to help 
you create both message and category files 
(see Figure 2) . You can use the buttons at the 
bottom of the screen to add a header (New 
Message File or New Category File) or add 
messages/ categories to the header (New Item) . 
I've color-coded the two different parts of the 
file for ease of use. You get a popup that allows 
you to select the error level (Information, 
Warning, or Error) when you add an item to 
the message header. 

Think of the entered text as a template. In 
Figure 2, the first item has a message ID of 1, 
a severity level of Information, and a text of 
(a single replaceable parameter). You 
could modify it to have, for example, a mes- 
sage ID of 1001, a severity level of Warning, 
and a text of "The file, % 1 , could not be 
located." (You can find the source code for 
this on the VSMWeb site; see the Go Online 
box for details.) One gotcha for the category 
files is that the index values must begin with 
1 and increase sequentially (this doesn't apply 
to the message file). 

Make Use of Categories 

Category resource files might seem like over- 
kill for your application, but categories are 
useful when you're searching for specific 
events, either manually in the event log applet 
or when you're using an automated program 
to manage the logs on multiple computers 
across the network. If you don't use a cat- 
egory resource file, you should always pass a 
zero to the category parametet in the Report- 
Event API call (this shows up as "None" in 
the NT event log viewet applet). 

You create three files when you hit the 
Save button. The first file is the *.MC file 
itself; the second is a BAT file to compile the 
message file (either Make_Msg.bat or 
Make_Cat.bat); the thitd is a simplified text 
dump of the choices you make before saving, 
ready for importing as comments into your 
VB program. For example, I got this in the 
MsgData.txt file for one run of CreateMC: 

1 Message IDs from EventMsgs . MC 

' 1. Informational, Application 

' 2, Warning, Application 

' 3, Error, Application 

You need both the message ID and the 
error level in your application program to 
create a record successfully in the event 



ImagXpress Professional 

Serious Imaging — Without Complications 

v n.„™ .„.,.,„ Major corporations world-wide are making 

PgHNm t ImagXpress the cornerstone of their new and 

tea:-:— existing imaging projects. Why? Because 

ImagXpress gives developers imaging 
technology that is powerful, flexible and best of 

|lP!f!Pj££ " With over 80 image-processing 

SE&raS^CDrCSS ancl su PP ort for over 30 file 

V !w3figrs JK ImagXpress includes the standar 

functions you expect, and the 
imaging features you need, like super-fast deskew and despeckle, 
ImagXpress supports multi-page TIFF, including compacting of multi- 
le files, TIFF tag editing, and Wang TIFF annotation compatibility, 
iress includes TWAIN scanner support, video frame capture, 
d printing support, and fully-programmable annotations. 
ImagXpress also offers expandability with add-on tookits M J^^^_^ 
for Barcode recognition and printing, Intelligent ^mHHHL^ 

Recognition (OMR) and high-speed ISIS scanning. ^KKMtKK/tm 

All of this comes in a clean, consistent Sj^^B^^ 
jgramming interface across the various ^BNSN&^^^jBm 

i/elopment environments you use. ImagXpress q^HHpT 
supports your platform of choice with COM objects, ^fPpj^^ 
lightweight ActiveX controls, and Delphi VCLs and 
provides samples for Visual Basic, VC+ + , C++ Builder, Delphi, Access, 
and HTML. 

Ease-of-use, high-performance, expandability, reliability and the best 
technical support in the business. These are the reasons why developers 
at major corporations are making ImagXpress their imaging toolkit of 
choice and that's why you should too. ImagXpress delivers serious 

;ations. 
ImagXpress today by 
www.pegasustools.com. 



Pegasus S< 
document imag 
information, conta 



nt at sa 




Pegasus Software 

4522 Spruce Street, Suite 200 

Tampa, Florida 33607 



(813) 875-7575 
(800) 875-7009 
Fax (813) 875-7705 



40 



Visual studio Magazine • September 2001 • www.vbpj.com • www.vcdj.com 



SECURELY LICENSE AND 
DISTRIBUTE SOFTWARE 





SentineILM™ 

Software-based solution 

for Electronic License Management 



SentinelExpress™ 

Software-based solution 

for Electronic Software Distribution 



Secures applications from 
unauthorized execution 

Protects developers and 
ISV's from illegal licensing 
and distribution 

Enables eCommerce for 
electronic software 
distribution 



Don't Let Others Compromise the Integrity of Your Software 



SuperPro 


SuperPro 797 


SuperPro USB 


Benefits 








■ Offers complete software 
protection that is easily 
integrated and simple 
to deploy 








■ Secures applications with 
powerful multiple-algorithm 
protection and 1 28-byte 
memory 








For more information please visit: sentinel.rainbow.com 


■ Enables remote software 
updating and demo upgrading 
to fully-licensed versions 



50 Technology Drive, Irvine, CA 92618 
1 .800.852.8569 • www.rainbow.com 

sales @ rainbow.com 



/FRAINBOW 

TECHNOLOGIES 

©2001 Rainbow Technolgies, Inc. 



NT Event Log^BBBBMBWHI 



log that doesn't have extraneous system 
error messages and is easily searchable. 

By default, CreateMC.exe creates the 
*.MC file,, the *.BAT file, and the *.TXT file 
in a directory one level up from the current 
directory. So if you install the CreateMC 
and WriteEvents2 projects in separate direc- 
tories under .AEventLogs, CreateMC saves 
those files in the EventLogs directory. The 
TestWrit.exe program, by default, registers 
the message and category DLLs in the 
EventLogs directory. 

After you create the message *.MC file 
(and, optionally, the category *.MC file), 
you need to execute the BAT file (Make_Msg 
or Make_Cat) to create the DLL. You can 
do this from Windows Explorer, but it's 
probably better to drop to the command 
line and run the batch file from there (so you 
can see any errors generated clearly). 

The requirement for these BAT files to 
work correctly is that MC.exe, RC.exe, and 
Link.exe must all be in directories included 
in the PATH environmental variable, or 
you need to modify the batch files you create 
to include the full path to those executables. 

Now you have the message DLL (and 



to register the 
same DLL for 
multiple logs, 
you must name 
each of them 
differently. 




optionally, the category DLL). The DLLs 
must have a specialized registration into the 
NT HKEY_LOCAL_MACHINE Registry 
hive. You can do this registration either 
manually (by creating a *.REG file and 
running it) or programmatically. I chose the 
programmatic method so I could wrap ev- 
erything up in one executable, but using a 
*.REG file might be more appropriate in 
some circumstances. 



Under HKLM\SYSTEM\CurrentCon- 
trolSet\Services\Eventlog\jc»c (where xxx is 
the event log's name, such as Application), 
you need to create a new key with your 
application's name. Call this key TestWrite- 
Events_Application. Under this key, add 
several new values (see Table 1). 

The EventMessageFile contains either 
the full path to the message DLL file, or a 
path containing environmental variables 
to be expanded at run time, such as %Sys- 
temRoot%\System32\ulib.dll. The Types- 
Supported normally contains 7, which is a 
combination of Error (1), Warning (2), and 
Information (4) types. If you're writing to 
the Security log, you might also have Success 
Audit or Failure Audit. 

Categorize Them All 

If you're including a Category file, you need 
to include the CategoryMessageFile (full 
path to the Category DLL) and the Category- 
Count (the number of categories you in- 
cluded in the file). In this article's 1996 
version, I added an entry to the Sources 
value programmatically under ..\EventLog\ 
NameofLog. This value is a REG_MULTI_SZ, 
which contains multiple, null-delimited en- 
tries. However, Richard Grimes points out 
in his articles that adding this value yourself 
is not only unnecessary (NT adds it auto- 
matically), but doing so can cause hard-to- 
diagnose problems (see Resources). I can 
confirm the quirky behavior. The moral is, 
don't touch this value yourself — let NT 
handle it. Curiously, NT appears to sort 
these entries in reverse alphabetical order. 

The WriteEvents2 component (ActiveX 
DLL) contains three public classes: cVersion, 
cRegisterEventSource, and cWriteEventLog. 
cVersion returns the version of the operat- 
ing system installed (you need to address 
some variations between NT versions). The 
cRegisterEventSource registers the message 
and category files described earlier. In this 
article's code project, the category file's reg- 
istration is optional — you must send a 
nonblank value for xi_strCategoryFile pa- 
rameter to register the category. 

The cWriteEventLog class contains a 
method to write an entry to the selected 
event log on the selected machine, and prop- 
erties to set the event category, event ID, and 
binary data for that event. The class also 
contains a method (LogNames) to return all 
the available event log names. In NT 4.0, it 
returns only the standard Application, Sys- 
tem, and Security names. But on Windows 
2000 or later, if you have a domain server, 
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you'll have some additional logs, such as 
Directory Service, DNS Server, and File 
Replication Service. Actually, you can create 
your own event logs in NT 4.0 or Windows 
2000, but this is poorly documented. In any 
case, the LogNames function returns any 
added logs. 

You can get this information by enumerat- 
ing the keys (not the values) under HKLM\ 
System\CurrentControlSet\Services\Event- 
Log. The majority of the code this function 
uses is in a friend function in cRegisterEvent- 



Source (GetLogNames) . All the other Registry 
functions and declares are in the cRegister- 
EventSource class, so I didn't want to dupli- 
cate them in the cWriteEventLog class, but 
calling the functions and declares from 
cWriteEventLog makes more sense. 

The TestWrite project is a test frame to 
exercise the WriteEvents2.dll (see Figure 3). 
Notice you can write to either the local or 
remote event log (assuming you have rights to 
do so on the remote machine). However, this 
ability is somewhat misleading, because I don't 



NT Event Log 
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Reg Msg File 
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Figure 3 Write to the Event Log. Once you create the message and category DLLs, you 
need to register that DLL to write to the log without getting errors in the log. The main 
program allows you to register and write to any of the event logs (you can have more 
than the standard three in Windows 2000 and later) except the Security log, and you can 
even write events to other NT computers assuming you have the rights to do so. 



Value 


Notes 


Key Type 


EventMessageFile 


Full path for the Message file (or a path 
containing environmental variables that will 
be expanded at run time). Required. 


REG_ 


_EXPAND_SZ 


TypesSupported 


The types of messages this file supports 
(Error, Warning, Information, and so on). 
Required. 


REG. 


.DWORD 


CategoryMessageFile 


Full path for the Category message file. 
Only used if you have a category file (or a 
path containing environmental variables that 
will be expanded at run time). 


REG. 


_EXPAND_SZ 


CategoryCount 


Number of categories in the Category 
message file. Used only if you have a 
category file. 


REG_ 


.DWORD 



Table 1 Add Values to Your New Key. Enabling the message DLL you create requires 
only two entries. You need two additional entries when you include a Category file. You 
get the value for the TypesSupported by adding together the constants for the types 
you'll be using; for example, EVENTLOG_ERROR_TYPE or EVENTLOG_WARNING_TYPE 
supports only Errors and Warnings. 
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include a way to register (or even copy) the message resource DLL to the 
remote machine. Currently, to avoid getting the "The description for 
event ID ( #### ) ..." message in the remote log, you need to run 
TestWrite on the remote machine to register those DLLs. The Log 
Name combo box is filled with the LogNamesO method. The label on 
the bottom showing the operating system version isn't necessary, but I 
included it to remind myself which version of NT I was testing on. 

Write an Entry Successfully 

You must know the category numbers, message ID, and error 
severity of the message entries to program the app to write an event 
entry successfully (see the MsgData.txt and CatData.txt files in the 

f VB5, VB6 • Call the WriteEventLog Method 



Private Sub cmdWri teEventl_og_Cl i ck( ) 

Dim enmLogType As enmLogType 

Dim abytDataBuffert ) As Byte 

Dim astrEventText( ) As String 

' Other DIMs not shown 

If optLocal RemotefO ) . Val ue = True Then 

strServerName$ - "" 
Else 

strServerName$ = _ 

Trim$(txtRemoteMachine.Text) 
End If 

strAppName = APP_NAME 
strEventLogName = cbotogName. Li st _ 

(Me.cboLogName. Li st Index) 
abytDataBuf f er = _ 

Me. txt Event Data .Text 

ReDim astrEventText (0 To 0) As String 

astrEventText(O) - Me.txtEventString.Text 
strAppNameMunged - GetAppNameMunged _ 

(strEventLogName, strAppName) 
If optErrorLevel (0) .Value = True Then 

enmLogType = Loglnfo 
Elself optErrorLevel ( 1 ) . Value = True Then 

enmLogType = LogWarning 
Elself optErrorLevel (2) . Value = True Then 

enmLogType - LogError 
End If 

IngEventID = CLng(cboEventID. ItemData 

( Me. cboEvent ID. List Index) ) 
IngCategory - CLng(Me . cboCategory . Li st 

(Me.cboCategory.Listlndex)) 
m_objEvntLog. EventDataBuf fer = abytDataBuf fer 
m_objEvntLog.EventCategory = IngCategory 
If UCase$(Trim$ (strEventLogName)) =_ 

"SECURITY" Then 

MsgBox "Only the LocalSystem acct can " & 
"write to the security log" 

Else 

On Error GoTo WriteLog_Err 

m_objEvntLog. WriteEventLog strServerName , 
StrAppNameMunged, enmLogType, _ 
IngEventID, strEventLogName, astrEventText 

End If 

Exit Sub 

WriteLog_Err: 

' MsgBox with error info 

End Sub 



Listing 1 Calling the WriteEventLog method in the WriteEvents.dll 
is straightforward. Most of the code deals with capturing infor- 
mation from the sample Ul, something you probably don't need 
in a real app. The Category and binary data (EventDataBuffer) are 
optional properties you can set. 



code download). Currently, this information is hard-coded within 
the test application. A real program probably knows exactly what log 
items it needs to write, so I'm not sure it's worthwhile to make this 
function data-driven. 

The TestWrite program must do a fair amount of extra work to 
function as a demo program. For example, you would normally write 
messages only to one event log (almost always the Application log). 
However, for demo purposes, I allow you to write to any log (except 
the Security log). When you write to an event log, NT searches only 
for the program's name, not the event log name and program name. 
The result: To register the same DLL for multiple logs, you must 
name each of them differently. I use the application's name plus an 
underscore and the log name's first 10 characters (with spaces 
removed) . Keep in mind that a nondemo program requires little effort 
from you in deciding which log to write to, whether it's a local or 

Public Sub WriteEventLog(ByVal xi„strServerName _ 
As String, ByVal xi_strAppName As String, 
ByVal xi_enmLogType As enmLogType, ByVal _ 
xi_lngEventID As Long, ByVal _ 
xi_strEventLogName As String, ByRef _ 
xio__aEventText( ) As String) 

Dim IngRtn As Long 

Dim 1 ngRegEvntLogHwnd As Long 

Dim IngUserSid As Long 

Dim 1 ngNumMessages As Long 

Dim strReplace As String 

Dim strServerName As String 

If Trim$(xi_strServerName) = vbNullString Then 

strServerName - vbNullString 
Else 

If Left$(Trim$ (xi_strServerName) , 2) _ 

<> "\\" Then 

strServerName = "\\" & xi_strServerName 
Else 

strServerName = xi_strServerName 

End If 
End If 

1 ngNumMessages = CLngfTransl ateArray _ 

(xio„aEventText( ) ,m_typMessages) ) 
1 ngRegEvntLogHwnd - Regi sterEventSource _ 

(strServerName, xi_strAppName) 
If 1 ngRegEvntLogHwnd = Then 

' Raise an error 
End If 

IngUserSid = GetSidt ) 
IngRtn = ReportEvent _ 

1 ngRegEvntLogHwnd , xi_enmLogType , _ 

m_l ngCategory , xi_l ngEventID , IngUserSid. _ 

1 ngNumMessages , m_l ngLenRawData . _ 

m„typMessages , m_abytDataBuffer(0) ) 
If IngRtn = False Then 

' Raise an error 
End If 

IngRtn - Deregi sterEventSource ( 1 ngRegEvntLogHwnd ) 
If IngRtn = False Then 

' Raise an error 
End If 
End Sub 

Listing 2 To log the event, you must first register the source of 
the resource strings (RegisterEventSource). After getting the 
information on the current user's SID, a relatively simple call to 
ReportEvent and a cleanup call to DeregisterEventSource 
complete the process. 



remote log, what error level and message you 
would write, and so on. 

The code in cmdWriteEventLog spends 
most of its time gathering the options the 
user selected within the UI, something you 
typically wouldn't do for logging an event in 
a real program (see Listing 1 ) . The Category 
ID and binary data (EventDataBuffer) are 
optional parameters. If you aren't using a 
Category resource file, pass a zero for the ID; 
otherwise, any number you pass is enclosed 
within parentheses in the event log. Notice 
that you can't write to the Security event log 
unless you impersonate the LocalSystem 
account, but that shouldn't be a big issue 
because you don't normally need to write to 
the security log. If necessary, you could 
create a service (probably not in VB) that 
runs as LocalSystem and write to the secu- 
rity log from that service. The actual call 
into the WriteEvent.dll comprises six pa- 
rameters: the server name (blank for the 
local server), application name, log type 
(enumerated value), EventID, the log's name 
(Application, and so on), and the actual 
replaceable parameters for rhe log text as a 
text array. 

The code in WriteEventLog needs to 
accomplish several tasks before writing to 
the log (see Listing 2). If you passed a 
nonblank server name, you must ensure 
that the string starts with double back- 
slashes. The event log API can't use the text 
array you passed as is, so you must first 
translate it into a specialized type variable 
with 99 items using the TranslateArrayO 
function (you can use between and 99 
replaceable parameters in an event log mes- 
sage). The array you pass through the uni- 
versal defined type (UDT) is an array of 
string pointers, and you only pass those 
that are filled in — not all 99 items. This 
function's code is included in this article's 
code download. The function also returns 
the number of replaceable parameters in- 
cluded in the passed text array. 

Next, you need to register the source for 
the event log messages (the *.MC file you 
compiled earlier). Finally, you need to get 
the current user's SID (download Listing 3). 
This isn't totally necessary, but it adds a nice 
professional touch to the log messages. If the 
ReportEventO API returns zero, an error 
occurred writing the event and an error is 
raised back to the calling application. You 
should deregister the event source with the 
DeregisterEventSource() API call after writ- 
ing the event. Deregistering the event source 



doesn't remove the Registry values; it merely 
closes the event log for writing. Compared 
to all the work you did to get to this point, 
writing the event itself isn't too difficult. 

When you pass the SID to the 
ReportEventO API, the user's name appears 
in the event log record. All you need to do is 
open a process token for the current process, 
then get the token information for the user 
running that process. Normally, this is the 
user who last logged onto the machine. 
However, you can run processes as, for 
example, LocalSystem (as in an NT service), 
or the application's author can impersonate 
other users so that process could return users 
besides the currently logged-on user. 

In the past, creating and compiling the 
necessary *.MC file comprised more than 70 
percent of the work in creating well-formed 
event log messages from VB, at least for me. 
Every time I needed to do this, I had to look 
up the information on MSDN to refresh my 
memory of how to do this correctly. Hope- 
fully, the included CreateMC.exe eases this 
particular pain. I like to learn new things, but 
I don't want to remember all the details for 
years and years. 



L.J. Johnson consults for various companies 
in Dallas. He has programmed in VB since its 
1 .0 release, and he is a Microsoft MVP and the 
Ask the NT Pro at www.devx.com/gethelp/. 
Find him at ljjohnson@slightlytiltedsoftware. 
com and www.slightlytiltedsoftware.com. 
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The company 

continues to grow and grow. And your system's transaction rates 
are climbing in lockstep with it. A big deal, for sure— but nothing 
to get anxious about. That's because SQL Server 2000 offers 
scalability for even the most demanding environments. So you 
know that no matter how much— or how fast— your system needs to 
expand, you'll have the tools to handle it. 

Part of the flexible Microsoft .NET Enterprise Server family, 
SQL Server 2000 recently achieved 20,000 SAP Standard Sales 
and Distribution (SD) Application Benchmark Users with a response 

time of 1.91 seconds on 
a 32-processor Unisys 
ES7000 system running 
as the database server 
in a R/3 4.6C 3-Tier environment, surpassing a result achieved 
with Oracle 8.1 running on a Sun system with 64 processors.' 
In addition to world-class performance, SQL Server 2000 has 
price/performance numbers that are 2.5 times better than 
the closest competitor.' Add to that native XML support in 
SQL Server 2000 and you've got the database that's ready to 
handle Web-enabled enterprise applications far into the future. 



To get the full story on Microsoft SQL Server 2000 scalability, g 
microsoft.com/sql/worldrecord Software for the Agile Busi 
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Install Databases 
a Better Way 

Creating a custom installation for your SQL Server 
database is a snap when you mix SQL-DMO and DTS. 
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2000 Data Transformation 
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Peterson [Sams, 2000, 
ISBN: 06723201 18] 
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Winter 1999/2000] 
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content/databases/ 
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by Josef Finsel 

SQL Server has always offered more than one way to install the database part 
of an application, but each of its traditional methods has its drawbacks. 
Fortunately, you can transcend SQL Server's installation limitations by using 
SQL Distributed Management Objects (SQL-DMO) and Data Transforma- 
tion Services (DTS) to create a small, highly automated database installation 
routine. The routine is flexible, so you can use it on other projects with minimal 
developer involvement. 



As early as SQL Server 6. 5 , you could either distrib- 
ute a backup of the database to be restored, or you 
could use a Transact-SQL (T-SQL) script to create the 
database and fill it with data. However, restoring a 
backup requires either your program or the installer to 
be able to work with the directory structures, and SQL 
scripts require more work on your part to create them. 
Starting in SQL Server 7.0, you could handle database 
installation in a new way, using the system stored 
procedures sp_attach_dbandsp_detach_db. But these 
methods also have their limitations. 

SQL Server stores a database in a combination of 
physical and log files. The sp_detach_db procedure 
severs the connection between the server and those 



files, allowing you to zip them up, transport them to 
another machine, unzip them, then use sp_attach_db 
to create a new database on another server. Although 
this is easier than restoring the database, it has a 
drawback as well — namely, the size of the files. Re- 
member, database files contain not only the data, but 
also all the indexes, statistics, and initialized space for 
the database to grow into. Even zipped, the database 
files can still be quite large. For instance, the zipped 
database files for author Bill Vaughn's sample Biblio 
database that you can download from his Web site are 
about 23 MB (see Resources). The backup file for 
Biblio zips down to 1 5 MB, but that still includes both 
index information and empty space waiting to be filled. 



Understand DRI 



Declarative Referential Integrity (DRI) is a fancy term meaning you need to verify that the data being used 
as a foreign key exists in the primary key table. Before DRI came on the scene, this type of functionality was 
available through triggers that fired when inserting or updating data. The trigger would verify that the newly 
inserted or updated data actually existed in the primary key table. This is known as procedural integrity. 

With DRI, you literally "declare" what values are acceptable, similar to declaring variables in VB. When 
SQL Server checks referential integrity, it does so at a system level instead of processing a trigger or stored 
procedure, so it's much more efficient. 
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You can use SQL-DMO and DTS to make these file sizes smaller. 

To do so, you could put together two T-SQL scripts to build the 
database, intermixed with some bulk copy commands to load the 
data. Although that wouldn't be flexible, it would provide the basic 
installation steps. First you'd need to script the creation of the 
database and any user-defined data types and tables, including 
defaults and primary keys. Once you create the database and tables, 
you'd need to load them. You can write a T-SQL script to load the 
data into the database; the Northwind and Pubs sample databases 
that come with SQL Server are both generated that way. The 
problem with scripting the load of data into the tables is two-fold. 
First, generating the insert commands can be a time-consuming and 
boring job, even if you write a program to generate the script for you. 
Second, the process can get difficult ifyou have any binary data. The 
T-SQL script that installs Northwind has the binary photos written 
out to their hexadecimal values, resulting in a large script you could 
modify easily to corrupt the pictures accidentally. 

Instead of scripting data loads, it's a better idea to use the bulk 
copy utility (bcp) . bcp is actually a command-line interface wrapper 
to ODBC's FastLoad API. It can copy data into or out of a database 



in a variety of formats, from formatted text to SQL Server's "native" 
format of binary data. Fortunately, you don't have to deal with bcp's 
cryptic command-line interface using the code for this article 
because you handle all the bulk copying through either SQL-DMO 
(for output) or DTS (for input). (Download the code from the VSM 
Web site; see the Go Online box for details.) 

Once you load the data, you need a final T-SQL script to create 
constraints for the tables, all views, stored procedures, and func- 
tions. Finally, you use a shell script to run everything to automate 
the process. 

Understand SQL-DMO 

SQL-DMO is a collection of objects that encapsulates SQL Server 
database and replication management. It handles creating a bulk 
copy file to use with the BULK INSERT command — a little-known 
fact. SQL-DMO is also handy for determining the order in which 
to create objects. 

First, you need to create the T-SQL scripts that create all the 
objects in the database. Fortunately, each object type in SQL-DMO 
has a Script method, and you can cycle through each object type's 



Get resultset of 
dependencies for 
a view 




EOF? 



Yes 



Is dependency 
a view? 



Yes 



No 




Yes 




Has the view 
been scripted? 



No 

I 



Call ScriptView 
with view name 




— — 

Figure 1 Avoid View Errors. If a view is dependent on another view, you must create the views in a specific order to avoid errors 
that stop the installation. Handle this through the ScriptView recursive function, which checks dependencies. Once ScriptView finds 
that a view is dependent on a second view, it checks to see whether that second view has been created. If it hasn't, ScriptView calls 
itself using the name of the second view to handle any dependency issues that view might have. 
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DTS and SQL-DMO 



J 



collection easily to create the T-SQL script for each object (see 
Listing 1 ) . The most confusing part of using the SQL-DMO Script 
method is figuring out which parameters you want to use. You want 
to use the SQLDMOScript_NoDRI parameter to create your tables 
while excluding any Declarative Referential Integrity (DRI) , such as 
foreign constraints (see the sidebar, "Understand DRI"). 

However, you can't ignore DRI entirely. You still need to create 
the primary key or clustered indexes when you create the table. If 
you don't, the tables are re-ordered physically when you create the 
clustered indexes, causing substantial wasted overhead in processing 
and disk space. Although I don't have space to cover them here, I've 
commented the Script parameters in this article's code project. 

After creating the tables, the next step is to populate them. 
Fortunately, creating bcp files and their accompanying BULK IN- 
SERT tasks is easy to do, but you need to take a couple things into 
account, primarily related to table names containing spaces. Although 
there's no problem creating the files, the spaces seem to get lost in the 
shuffle when DTS translates the properties into the T-SQL BULK 
INSERT command. To overcome this, you need to replace all the 
spaces with CHR(255), a character not allowed in a table name. 
Second, note how DTS translates the table name for the BULK 
INSERT. In all the created scripts, the SQLDMOScript_Use- 
Quotedldentifiers puts brackets (0) around object names so that a 
space in the middle of the filename won't cause problems. I kept 
getting errors in the DTS package until I started putting brackets 
around the object names in the Bulklnsert task. Although DTS has 

. 

( VB6 • Use the SQL-DMO Script Options to Create Tables^ 



Private Sub CreateTabl es( ) 
Dim oTable As SQLDMO. Table 
Dim sSQL As String 

sSQL = "USE " & cmbDatabases.Text & vbCrLf & _ 

"GO" & vbCrLf 
For Each oTable In oCurrentDB . Tabl es 
If oTabl e . SystemObject - False Then 
With oTable 

sSQL = sSQL &. Script _ 
(SQLDMOScript_Default Or 
SQLDMOScri pt_NoDRI Or _ 
SQLDMOScri pt_OwnerQualify Or _ 
SQLDMOScri pt_Permi ssi ons Or _ 
SQLDMOScript_Triggers Or _ 
SQLDMOScri ptJseQuotedldenti f i ers ) 
8. VbCrLf 
sSQL = sSQL & .Script _ 

(SQLDMOScript_DRI_PrimaryKey Or ^ 
SQLDMOScri pt_DRI_Def aul ts Or _ 
SQLDMOScriptJwnerQual ify Or _ 
SQLDMOScriptJJseQuotedldentifiers) & vbCrLf 
End With 
End If 
Next 

ExecuteSQLStepTaskBui 1 d oPackage, _ 

"Build Tables", "Build Tables", sSQL, True 
End Sub 



Listing 1 Creating a table requires you to create not only the 
table, but also the primary key and any clustered index on the 
table. Although you could create the clustered index after the 
fact, this expands your database size because the clustered index 
makes a copy of the table, then reorders the data physically. 



an option to perform BULK INSERTS using wide-native format to 
handle Unicode, there isn't an enum for copying dara out in that 
format from SQL-DMO. 

The last gotcha related to loading the tables has to do with the 
bcp file location. When you run a DTS package, it assumes any file 
referenced without a full path is relative to the SQL Server installa- 
tion. However, this isn't insurmountable. You simply need to use a 
global variable within DTS to reference the path of the DTS files. 
A sub in the code project named AddUNCPathNameToBulk- 
InsertFiles creates a VBScript step that takes the sPath global 
variable and uses it in front of all the Bulklnsert steps. It's a fairly 
simple script, walking through all the tasks in the package and 
modifying all the ones whose name starts with BULKINSERT. 

Deal With Dependency Issues 

Now that you've built arid loaded the tables, you can script the table 
constraints, views, functions, and stored procedures. The table 
constraints define dependencies for the tables, so the act of creating 

VB6 • Build Views in the Correct Order ^ 



Listing 2 Determining dependencies through a recursive function 
allows you to build your views in the correct order. If a view is 
dependent upon another view that hasn't been built, the 
installation stops with an error. This function avoids that by looping 
through the list of dependencies required for a view and builds 
any required views first. 



Private Function Scri ptVi ew( ByVal oView As 

SQLDMO. View) As String 
Dim qView As QueryResults 
Dim rs As ADODB. Recordset 
Dim oView2 As SQLDMO. View 
Dim sViewSQL As String 
Dim sView As String 
Dim sViewOwner As String 

Set qView = oVi ew . EnumDependenci es _ 

(SQLDMODep_Parents) 
Set rs = QueryResultToRecordset(qView) 
sViewSQL = "" 
Do While Not rs.EOF 

If rsloType = S0LDM00bj_Vi ew Then 
sView - rsloObjName 
sViewOwner = rsloOwner 
Set oView2 = oCurrentDB. ViewstsView, _ 

sVi ewOwner) 
sViewSQL = sViewSQL & Scri ptVi ew( oVi ew2) 
& vbCrLf 
End If 
rs . MoveNext 
Loop 

If Not dctViews.ExiststoView. Owner & "." & 
oView.Name) Then 

sViewSQL = sViewSQLoVi ew. Script _ 
(SQLDMOScript_Default 
Or SQLDMOScript_OwnerQual ify Or 
SQLDMOScript_Permissions Or 
SQLDMOScript_Drops Or _ 

SQLDMOScript_UseQuotedIdentifiers) & vbCrLf 
dctViews.Add oView. Owner & "." & oView.Name, 
oV1ew. Owner & "." & oView.Name 
End If 

ScriptView - sViewSQL 
End Function 
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the tables and loading them befote creating the constraints handles 
any dependency issues for them. Unfortunately, that doesn't work 
for views. A view can be dependent not only on tables but also on 
other views — meaning you need to determine the order to create 
views in (see Figure 1). 

The good news is that SQL-DMO has a method for this called 
EnumDependencies. EnumDependencies returns a QueryResults 
object. You don't manipulate QueryResults like an ADO-DB 
recordset, but MSDN has a function that converts it to a recordset 
called QueryResultToRecordset (see Resources). You use that 
recordset to determine whether the view is dependent on another 
view, and whether that parent view has been scripted already (see 
Listing 2). If there's a dependency, you create the parent view first 
and add it to the dictionary of views. This can happen anytime you 
have views that are dependent upon other views. In SQL Server 
2000, you can also have views dependent upon user-defined func- 
tions (UDFs), or UDFs dependent upon views. That type of 
dependency requires that you create objects in a specific order. 

Now that you understand the pertinent parts of SQL-DMO 
programming, it's time to turn to DTS programming. DTS is a set 
of graphical tools and programmable objects designed to extract, 



transform, and consolidate data. But in this case, you use its ability 
to create a controlled sequence of steps that you can run from a 
command line to handle the database installation. 

The first step is to create a package. The one unique thing about 
this package is its global variable, which you'll use to tell DTS 
where to find the bcp files to load the tables. Second, because most 
of the tasks are running T-SQL statements, you need to create a 
routine to create a step and task and set the T-SQL for the task (see 
Listing 3). Because creating a database requires you to create 
objects in order, each task in the package is part of a step, and the 
steps move sequentially from creating the database through creat- 
ing the stored procedures. 

Creating a task to execute SQL code requires two steps. First, you 
create the task, then you create a custom task for the task (in this case, 
a DTSExecuteSQLTask). Once you create the step, task, and 
custom task, finish by setting the step's precedence using the 
SetPrecedence procedure. This procedure keeps track of the last step 
added and sets it to precede the current step. 

DTS packages don't actually exist until you save them. All the 
steps and tasks are added to a virtual package until you save the 
package, at which point DTS generates a GUID for a PackagelD. 



VB6, T-SQL • Split Up Task Creation 



Sub ExecuteSQLStepTaskBui 1 d( oPackage As _ 

dts. Package, ByVal sGenericName As String, _ 

ByVal sQescription As String, ByVal _ 

sSQLStatement As String, ByVal _ 

bEndExecuti onOnFai 1 As Boolean) 
Dim oStep As dts. Step 
Dim oTask As dts. Task 
Dim oCustomTask As dts . ExecuteSQLTask 
Set oStep - oPackage . Steps . New 
With oStep 

.Name = sGenericName 

.Description - sDescription 

. Executi onStatus = 1 

.TaskName = "Execute SQL Task: " & sGenericName 
.CommitSuccess = False 
. Rol 1 backFai 1 ure = False 
. Sen ptLanguage = "VBScript" 
. AddGl obal Vari abl es = True 
. Rel ati vePri on ty = 3 
. CI oseConnecti on - False 
. ExecutelnMai nThread = False 
. IsPackageDSORowset = False 
.JoinTransactionlfPresent - False 
.DisableStep = False 
End With 

oPackage . Steps .Add oStep 

Call SetPrecedence(oStep, bEndExecuti onOnFai 1 ) 
Set oTask - oPackage .Tasks . New( "DTSExecuteSQLTask" ) 
Set oCustomTask = oTask . CustomTask 
With oCustomTask 

.Name = "Execute SQL Task: " & sGenericName 

.Description = sDescription 

.SQLStatement = sSQLStatement 

.ConnectionID = 1 

.CommandTimeout - 



End With 

oPackage .Tasks .Add oTask 
Set oCustomTask « Nothing 
Set oTask - Nothing 
End Sub 

Private Sub SetPrecedencetByRef oStep As _ 
dts. Step, Optional ByVal bEndExecuti onOn Fa i 1 
As Boolean) 

Dim oPrecConstrai nt As dts . PrecedenceConstrai nt 
If IsMi ssi ng( bEndExecutionOnFai 1 ) Then 

bEndExecuti onOnFai 1 = True 
End If 

If sLastStepName <> "" Then 
Set oPrecConstraint = _ 

oStep.PrecedenceConstraints.New _ 

( sLastStepName ) 
With oPrecConstraint 

.StepName = sLastStepName 
If bEndExecuti onOnFai 1 Then 

. PrecedenceBasi s = _ 
DTSStepPrecedenceBasi s_ExecResul t 

.Value = 
Else 

. PrecedenceBasi s = _ 

DTSStepPrecedenceBasi s_ExecStatus 

.Value = 4 
End If 
End With 

oStep.PrecedenceConstraints.Add 

oPrecConstrai nt 
Set oPrecConstraint = Nothing 
End If 

sLastStepName = oStep.Name 
End Sub 



Listing 3 Most of the tasks to be executed in this package are T-SQL commands, so it's easy to split the creation of these tasks and 
steps into a sub. ExecuteSQLStepTaskBuild creates the actual step to execute the T-SQL command. Once it has finished generating 
the step, it calls SetPrecedence so the steps will execute in order. Then it builds the custom task that contains the T-SQL command 
to execute. 
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LEAD Technologies has ten years of experience developing digital imaging technology and creating programming toolkits for the 
development community. Over those ten years LEAD has created imaging technology that is currently used by Microsoft, Intel, Hewlett 
Packard, Eastman Kodak, Reuters, Corel and many other world class companies. Ten years experience developing imaging technology 
and solving programmer's problems have produced the engines listed below. Visit our web site for full details on available LEADTOOLS 
products which utilize these powerful engines. 
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RASTER IMAGING ENGINE 
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Import and export 60+ raster file formats - Supports a wide range of 
compression options, bit depths (up to 64) and color spaces. Progressive 
and non-progressive modes, multi-page, animation and non-image data. 

Image processing - Transforms- resize, rotate, linear and bicubic 
interpolation, flip, invert, reverse, crop, underlay, shear, transpose, auto 
deskew and combine. Filters - sharpen, intensity, saturation, histogram, 
posterize, median, edge, noise and more. Spacial filters - gradient, 
laplacian, sobel, prewitt and more. 

Display - scroll, scale with interpolation, dither, contrast, brightness, with 
a choice of over 2,000 special effects. 

Scanning, printing, imaging common dialogs, thumbnail browser, image 
list, database imaging functions, screen capture and much more! 
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Powerful annotation capabilities - Enable the addition of text, 
highlights, sticky notes, audio, ellipses, buttons, lines, arrows, rectangles, 
polygons, redaction, hotspots, freehand scribble, pointers, bitmaps, 
stamps, rulers and hyperlinks all with user-defined security features. 
Document image processing and clean-up- Despeckle, deskew, 
inverted text, removal of dots, blobs, lines, borders, hole punches, 
character smooth. Region of interest, preview of changes and composite 
viewing of the modified regions. 

Optimized viewing of bitonal images - Specialized display filters 
including FavorBlackand ScaleToGray, bilinear and bicubic interpolation. 
Also includes ultra-fast CCITT G-3, G-4 and rotation, JBIG compression 
and a pan-window. 



DICOM 3.0 - Supports the latest specs, including all standard IOD classes 
and modalities (CR, CT, MR, NM, US, RF, SC, VL, Worklist, etc.) and 
DICOM directory. 

DICOM communications protocol - COMPLETE support including all 
Service Classes (Verification, Storage, Query/Retrieve, Patient 
Management, etc). High-level communications functions to simplify the 
creation of DICOM client/server applications. 

Optimized image processing - The richest in the industry supporting 
1,2,3,4,5,6,7,8,12,16,24 and 32 bit images. Includes 8-16 bit grayscale 
display with window leveling and LUT support. 

Includes Medical specific measuring and mark-up annotations like cross 
product, ruler, point and protractor. 
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Support for client server development over the Internet or LAN - 

Provides a framework for sending /receiving commands (LOAD, SAVE, 
CREATEWIN, etc.) from one computer to another. 

Control Image processing remotely - Allows for creation of "remote 
control" type applications where image processing can take place on a 
remote computer. 

Small COM objects and ActiveX controls - Internet enable 
LEADTOOLS Raster imaging functionality but greatly reduce 
redistribution requirements. 

New HTTP and FTP functionality - Provides programmatic control of 
FTP & HTTP servers. 

Upload Control - For sending files to an HTTP server. 

30-DAY MONEY BACK GUARANTEE (US & Canada) 

•License required from Unisys for formats using LZW compression. LEAD and LEADTOOLS are registered 
trademarks of LEAD Technologies, Inc. ISIS® is a registered trademark of Pixel Translations, a division of Input Software, 
Inc. All other product names are trademarks of their respective owners. LEADTOOLS is available in several versions, white 
not every feature is available in every version, you can easily find the toolkitto match your needs by visiting our website. 



Import/export - DWG, DXF, DWF, EMF, WMF, CGM, DGN, DRW, HPGL, 
HPGL2, PICT and LEAD VEC (LEAD'S proprietary file format) in native 
form. 

Editing - 14 different primitive object types (Vertex, line, rectangle, 
polyline, polybezier curve, polygon, ellipse, circle, arc, text, pie, chord, 
polydraw, and raster). Group objects into layers, copy or move objects 
between layers, lock individual layers. Add, edit, delete, rotate, translate 
and scale objects and layers. Convert points from world space to screen 
space and vice versa. Pixel accurate hit testing. 

Also includes 3-D viewing (lighting, shadow, camera), 3 vector engines 
(GDI, OpenGL and DirectX), convert or overlay vector drawings to any 
LEAD supported rasterformat. 



J MUIT.MED.AJMA^JNGINE 



Play, Edit and Save - Comprehensive support of multimedia formats 
including AVI, WAV, MIDI, SND, AIF, AIFC, MPEG-1 , MPEG-2files. 

Capture - Capture multimedia data from any Video for Windows or 
DirectShow capture device. 




Happy Annlvramry, L KADI 
www.leadtools.com 

sales@leadtools.com or call: 800-637-4699 




DTS and SQL-DMO j 



This PackagelD is important, because it's required to tell DTSRun 
which package should be run. If you modify the package later, you'll 
create a new package with a different PackagelD. 

You need to know the PackagelD to run the package from the 
command prompt or from the program control. You also can pass 
DTSRun the value of any global variable. In fact, you need to use four 
parameters to run the package from the command line: /N is the 
package name within the structured storage file, /G is the PackagelD, 
/F is the structured storage file, and /A is the global variable. 

Fortunately, SQL Server 2000 also has a tool called DTSRunUI 
that provides a user interface to the DTSRun command and builds 
the actual command for you (see Figure 2). Once you open the 
structured storage file and select the package within the file, you can 
click on the Advanced button, drop down any global variables that 
exist, and provide the values. Once everything is ready, click on the 
Generate button to see what code you need to run from the 
command prompt to process the package. Warning: Spacing is 
critical for this. I generated this command to a shell script after I 
finished creating the package, and it kept failing on me because I put 
two spaces after the PackagelD. 

Now that you've finished, was it worth it? The Biblio database 
backup now zips down to 15 MB; the DTS package zips down to 
less than 7 MB. This package works on several databases I've tested, 
but it does have some potential problems. In SQL Server 2000, you 
can use UDFs in a view, meaning you need to include them in the 




The FastestDatabase Engine 

Discover CodeBase, the fastest database engine on 
the market that's also fully xBASE compatible. 
Query a million-record table in 0.34 seconds, or read 
300,000 records in just 0.59 seconds. It's lightning quick! 
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This application was 
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Figure 2 Build Commands More Easily. DTSRunUI is a handy 
utility that's often overlooked when discussing DTS. This utility 
lets you select a package easily and define the command prompt 
settings for any global variables you might have. Once you define 
all your settings, simply press a button to get a correctly formatted 
command you can place into your program or into a command 
file to run the package. 

dependency checks. In testing my application, I also discovered that 
some of the databases I tested against had redefined system tables as 
user tables. That's a poor coding practice to begin with, and it will 
stop your package from running because you aren't allowed to 
update system tables directly. But even in cases where you might 
need to tweak the resulting package, this little utility takes the 
drudge work out of your database installation work, l 



Josef Finsel is a software consultant with G.A. Sullivan, a global 
software development company, and the author of several technical 
articles. You can reach him at reluctantdba@finsel.com. 
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FREE .NET Web Controls! 



WITH C# SOURCE CODE 



Pops 



for .NET Beta 2 



Retrieve E-mail from any P0P3 Server 

SoftArtisans POP3 is a Post Office Protocol (POP) client 
Web control. This robust control allows Web developers to 
write customized POP3 client applications in the .NET 
Framework. Retrieve, read, store or delete mail in private 
mailboxes. SoftArtisans POP3 provides a new method for 
client machines to dynamically access mail from a server. 
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Easily Navigate your XML data 

SoftArtisans TreeView is a powerful .NET Framework control that provides 
easy navigation for Web sites hosted under the .NET Framework. This 
control implements several powerful features, including support for data 
binding and the use of rich DHTML SoftArtisans TreeView has highly 
customizable rendering options and layout. Most interfaces that use the 
SoftArtisans TreeView can be authored declaratively using simple markup 
syntax, but the control can also be accessed programmatically. 
Dynamically expand and collapse tree nodes in hierarchical, menu-based, 
or tabular views. 

• Customize graphical representation with CssFile or CssClass. 

• XslFile property allows customization of XML representation. 

• CachedLevel controls number of levels to be sent with each 
roundtrip. 

• DataSource can XML file or reference to System.Xml.XmlNode 
(allows facilitation of ADO.NET DataSets). 



visit www.softartisans • COITI to start your transition to .NET today! 
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Synchronization 

JustlnTimeActivation 
ObjectPooling 

AutoComplete 

Securityflole 

MustRunlnClientContext 
ConstructionsEnabled 

EventTrackingEnabled 

ComponentAccessControl 
LoadBalancingSupported 

Description 
ExceptionClass 



Specifies C0M+ (distributed) transaction support. 

Possible values reside in the TransactionOption 

enumeration: Ignored. None, Required, RequiresNew, Supported. 

Specifies C0M+ concurrency support. Possible values reside in 
the SynchronizationOption enumeration: None, Required, 
RequiresNew. Supported. 

Specifies Just In Time Activation (JITA| support. 

Specifies support for object pooling. Properties on this attribute 
allow you to configure the minimum and maximum size of the 
pool and the creation timeout. 

Allows you to make a method = "auto complete." meaning 
COM* calls SetComplete if the method returns without S_0K 
and SetAbon if the method returns an error. 
Adds a role to a COM+ application and specifies that a class 
requires users to be in the roie. 

Specifies that a class must run in the same context as its client. 
Specifies that a class supports construction strings. Use the 
default property of this attribute to specify an initial value for 
this construction string. 

Specifies that a class supports events and statistics 



Specifies whether role-based security checks are performed 
at the component level. 

Specifies whether a component supports the Component 
Load Balancing service available in Microsoft 
Application Center Server. 

Allows you to specify a description for a class 

For queued components, allows you to specify that a class 

will receive exceptions. 
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Target Multiple Devices 

You don't need to know tons of device-specific languages to 
make your Web pages accessible to different devices. You 
can serve Web pages to multiple devices dynamically by 
creating a custom server control in .NET. 

by Dan Wahlin 

68 

C# Explorer 

Delve Into Delegates 

One of the most common misconceptions among 
developers learning C# is that delegates are "just like 
function pointers." In reality, C# delegates represent a 
significant leap forward in functionality. 

by Steve Lardieri 

72 

Web Services 

Use COM+ Services With .NET 
Components 

COM+ services aren't going anywhere— you still need them 
to build enterprise-class, distributed applications. Thanks to 
attributes and dynamic registration, it's easy to create .NET 
components that use them. 

by Alan Gordon 
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• Openwave Software 
Development Kit 4.1: http:// 
developer.openwave.com/ 
download/index.html 

• .NET Developer Center: http:// 
msdn.microsoft.com/net/ 

•ASP.NET Mobile Internet 
Toolkit: http:// 

msdn.microsoft.com/vstudio/ 

nextgen/technology/ 

mobilewebforms.asp 

• "Leveraging SQL Server's 
XML Features" by Dan Wahlin 
[XML Magazine Winter 2000/ 
2001]: www.xmlmag.com/ 
upload/free/features/xml/2000/ 
05win00/dw0005/dw0005.asp 

• "Customize XML Data with 
SQLServer" by Dan Wahlin 
[XML Magazine February/ 
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com/upload/free/features/xml/ 
2001/01jan01/dw2_0101xml/ 
dw2_0101xml.asp 

• XML for ASP.NET Developers 
by Dan Wahlin [Sams, 2001, 
ISBN: 0672320398] 



Create a custom server control in .NET to 
serve data to different types of devices. 



by Dan Wahlin 

Gone are the days of simply creating rich HTML pages you can view in a 
browser. In today's mobile world, you need to serve up data to a variety of 
devices. These include many different browser versions, personal digital 
assistants (PDAs) such as the Palm and Pocket PC, Internet-enabled phones 
and pagers, and other devices that will be released in the near future (don't 
forget the upcoming Internet-enabled refrigerator that can order your milk!). 



Each device brings with it different screen sizes, data 
transfer formats, and bandwidth limitations. In this 
article, I'll show you how to ease multiple device 
support issues by creating a custom server control in 
.NET that detects the calling device and transforms 
XML data into the proper format dynamically. 

Traditionally, targeting multiple devices involves 
creating different pages intertwined with program- 
ming and device-specific code such as Wireless Markup 
Language (WML) or HTML (see Figure 1). Al- 
though this architecture gets the job done, main- 
taining the different pages can be a nightmare 
because the programming code (VBScript, JScript, 
and so on) and HTML, WML, or other device- 
specific code exist within the same file. These 
pages often require you to know the language used 
in each device-specific page thoroughly, making it 
difficult to divide labor between graphic artists 
and developers involved in the application. 

Another downfall of the device-specific ap- 
proach shown in Figure 1 arises when new de- 
vices are released. You must be involved in creat- 
ing the device-specific page to generate the proper 
code. Although this is certainly good job secu- 
rity, creating these pages often tends to be redun- 
dant and laborious, especially because you're 



simply repurposing the same data for the new device. 

The .NET platform offers several alternatives to 
combat this problem, including Active Server 
Pages.NET (ASP.NET) Mobile Internet Toolkit and 
the more generic XML and Extensible Stylesheet Lan- 
guage Transformations (XSLT) approach. ASP.NET 
Mobile Internet Toolkit lets you target multiple devices 
such as PDAs and Internet-enabled phones from a 
single code base. This is a good solution if you're aware 




Figure 1 Traditional Architectures Have Limitations. 

Traditional architectures designed to target multiple 
devices involve mixing programming code with device- 
specific code such as HTML or WML. Although functional, 
this type of architecture makes it difficult to divide labor 
among developers with varying skill levels. 
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of the different controls you can use and have 
some programming experience. 

Create Stylesheets 
With XML 

The XML/XSLT approach lets you create 
different stylesheets for each device the appli- 
cation targets. XSLT is an XML-based lan- 
guage you can use with an XSLT processor to 
transform XML into many different formats, 
such as HTML, WML, flat-file, and even 
other forms of XML. With this approach, 
you can use the .NET platform's asp:Xml 
server control (or different classes in the 
System.Xml namespace), which simplifies 
coding your application greatly. Individuals 
with little to no programming knowledge can 
use the control in an ASP.NET page much 
like a regular HTML tag. Here's an example 
of how to use this control: 

<asp:Xml id="trans" Runat="server" 
Document Source=" XML/ courses . xml " 
Trans formSource-" XSLT /Courses/ 
courses_downLevel .xslt" 

/> 



This code transforms the courses.xml file into a different structure 
with the courses_downLevel.xslt stylesheet. Although it's useful and 
simple, the asp:Xml control isn't designed to target multiple devices 
per se, and it accepts a limited number of XML data sources and 
XSLT stylesheets. 

You have a third option: Create a custom control that targets 
multiple devices, which developers of varying skill levels can use. The 
control, called MultiDeviceTransform, is simple to use yet capable of 
more advanced tasks as needed by an application, such as passing 
parameters to XSLT stylesheets and using a variety of XML sources 
(including database sources). Using the control is as simple as adding 
a TagPrefix, Namespace, and Assembly reference to an ASP.NET 
page along with the control-specific code (see Listing 1). The code in 
this article uses C#, but you can use VB.NET as well to create the 
control; you can download both versions from the VSAfWeb site (see 
the Go Online box for details). 

The code in Listing 1 applies the "wc" TagPrefix to the 
MultiDeviceTransform control. The different attributes specify the 
XML data source and XSLT stylesheets to use for the supported 
devices. (See Figures 2 and 3 for the results of a browser- and Internet- 
enabled phone hitting the ASP.NET page that instantiates and uses 
the MultiDeviceTransform control.) 

The control uses XML and XSLT as its basis because XSLT can 
transform XML into virtually any structure. People with varying 
skill levels can create XSLT stylesheets, so XSLT is a good choice 
when it comes to targeting multiple devices. The XML data 
consumed by the control can come from a wide range of sources, 
such as static or dynamically generated XML files, an XmlDocument 
class, an XmlTextReader class, a DataSet class, or SQL 2000 HTTP, 
template, or EXPLICIT queries. 

The control can also accept several different XSLT stylesheets 
geared toward generating the calling device's proper output format. 
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Figure 2 Target an Up-Level Browser (IE4+). The MultiDeviceTransform code allows 
you to leverage strengths such as Dynamic HTML (DHTML) found in newer browsers 
by creating an XSLT stylesheet to generate the appropriate HTML. You can send less 
complex code to browsers that don't support more advanced features. 
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Figure 3 Target an Internet-Enabled Phone. As wireless 
connections support greater bandwidths, you'll see more powerful 
devices being released. In cases where these devices support 
WML, the MultiDeviceTransform control can generate the desired 
output format expected by the device. 

Device-specific XSLT stylesheets supported currently include up- 
level browsers (Internet Explorer 4.0 or later), down-level browsers 
(any browser other than IE4 or later), PDAs (Palm and Pocket PC), 
and WML- aware devices. 

As new devices arrive on the market, you can update a simple XML 
configuration file to target the devices automatically (I'll discuss this 
later). This makes adding devices into the previously mentioned 
categories (up-level, down-level, PDA, and WML) a simple and quick 
process. If you're tasked with creating the XSLT stylesheets, you can 
then work on creating the stylesheet used in generating the proper 
device-specific output. 

It's time to take a closer look at how to design and create the 
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MultiDeviceTransform control. When you create a server control, 
you can choose to inherit functionality from one of two base control 
classes: WebControl or Control (see Table 1). 

The MultiDeviceTransform control derives from Control be- 
cause no visual interface is needed (see how to use Control in 
Listing 2). You find the Control class in the System.Web.UI 
namespace, which you must reference in the code. You need to use 
several other namespaces as well: 

using System: 

using System. Web; 

usi ng System. Web. UI : 

using System. Xml ; 

using System. Xml .XPath: 

using System. Xml .Xsl ; 

using System. Text; 

using System. Data . Sql CI i ent ; 

using System. Data; 

using System. Configuration ; 

using System. 10; 

using System . Col 1 ecti ons ; 

using System. ComponentModel ; 

Classes within the System. Xml, System.Xml.XPath, and 
System.Xml.Xsl namespaces handle the control's built-in XML and 
XSLT capabilities. The System.Data and System.Data.SqlClient 
namespaces handle SQL Server 2000 features. Make sure to reference 
the System. ComponentModel namespace so you can use the 
TypeDescriptor class. This class lets you convert strings to enumera- 
tion members and avoids the overhead of creating your own conver- 
sion methods. You'll see how to use this class later in the article. 

Listing 2 shows the actual namespace and class definitions for the 
MultiDeviceTransform control. It also shows the different private 

f ASP.NET, XML • Use the Control in an ASP.NET Page^\ 



<%@ Register TagPrefix="wc" Namespace="Transform" 

Assembly-"WC . Transform" %> 
<%@ Page 1 anguage="c#" Src="def aul t . aspx . cs" 

Codebehind-"default.aspx.cs" 
AutoEventWi reup="fal se" 

Inheri ts-"TeeTimes . TeeTi mesSta rt " %> 

<wc :Mul ti Devi ceTransf orm id=" trans" 
runat="server" 

Devi ceConf i g F i 1 e="devi ce . conf i g" 
Xml FileSource-"XML/courses.xml " 
XSLTWML="XSLT/Courses/states- 

courses_wml .xsl t" 
XSLTUpBrowser= 

"XSLT/Courses/states-coursesUp.xslt" 
XSLTDownBrowser= 

"XSLT/Courses/statesDown .xsl t "> 
XSLTPDA = 

"XSLT/Courses/states-courses_pda .xsl t" 
</wc:Mul ti Devi ceTransf orm> 



Listing 1 Using the MultiDeviceTransform control within an 
ASP.NET page is as simple as declaring the Namespace and 
Assembly to use along with a TagPrefix After you specify the 
control information, use XML syntax to instantiate and pass 
property values to the control. Notice that the control's class name 
is prefixed with a "wc" TagPrefix. 



fields the control uses to store information that can be Get and Set 
through property accessors. 

Immediately after the private fields shown in Listing 2, the class 
defines an enumeration named DeviceTypesEnum that you use 
throughout the control's code to track the targeted device (I'll show 
you how to detect the device shortly): 

public enum DeviceTypesEnum I 
PDA, 
WML. 

UpLevel , 
DownLevel , 
Unknown 

I 

^ C# • Define the MultiDeviceTransform Control's ^\ 
Namespace and Class 

namespace Transform I 

public class MultiDeviceTransform : Control I 
//Define Xslt style sheets for different 
//devi ces 

private string _xsltWml = Stri ng . Empty ; 
private string _xsltPda - Stri ng . Empty ; 
private string _xsl tUpBrowser = 

String. Empty; 
private string _xsl tDownBrowser = 

String . Empty; 

//Define XSLT params 

private Xsl tArgumentLi st _xsltWml Params = 
null ; 

private Xsl tArgumentLi st _xsl tPdaParams - 
null ; 

private Xsl tArgumentLi st 

_xsltUpBrowserParams = null; 
private Xsl tArgumentLi st 

_xsl tDownBrowserParams = null: 

//Define XML source, type 
private string _xml Fi l eSource = 

Stri ng. Empty : 
private XmlDocument _xml DocumentSource = 

null ; 

private Xml TextReader _xml ReaderSource - 
null ; 

private string _xml Sql Expl i ci tSource = 

Stri ng . Empty; 
private Sql Command _xml Sql Expl i ci tCommand = 

null ; 

private DataSet _xml DataSetSource = null; 
private string _connecti onStri ng = 

String . Empty ; 
private string _devi ceConf i gFi l e = 

String. Empty; 
private bool _cancel Transform = false; 
private bool _debug - false; 
//Get Context of ASP.NET App 
private HttpContext context - 

HttpContext . Current ; 

// . . . more code f ol 1 ows 



Listing 2 The MultiDeviceTransform control derives from the 
Control class to obtain functionality required by server controls 
running in an ASP.NET page. If the control had visual characteristics, 
it would derive from the WebControl class instead. This code shows 
the private fields used within the class. 
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Although you could use a string or integer value to track the calling 
device, using an enumetation makes the code much easier to read 
and maintain. The MultiDeviceTransform control also defines 
several different property accessors (see all the properties in Table 2) . 
These accessors allow you to set the XML input source, the device- 
specific XSLT stylesheet paths, and several other miscellaneous 
properties such as the database connection string (when necessary). 
For example, use the XmlFileSource property to Get and Set the 
XML source file path: 



public string 


XmlFileSource { 


get 1 




return _ 

I 


.xmlFileSource: 


set { 




_xml Fi 1 eSource - value; 


('Class 


Description 


Control 


This class is found in the System. Web. Ul 




namespace and contains the properties. 




methods, and events common to all ASP.NET 




server controls. In cases where your custom 




control has no visual interface (such as the 




MultiDeviceTransform control), you should 




derive from this class. 


WebControl 


This class is found in the System.Web.UI.- 




WebControls namespace and derives from 




Control. Derive from this class when you 




require Ul functionality such as ForeColor, 




BackColor, and so on. 



Table 1 Choose Between the Control and WebControl Classes. 

You can derive from two base classes when writing server controls, 
including Control and WebControl. Discover the differences between 
the two classes and when you should derive from each. 



C# • Override the Render() Method in Custom A 
Server Controls 

protected override void RendertHtmlTextWriter 
writer) { 

//Allow consumer to cancel RenderO 

if (this.CancelTransform) writer. Writet "") ; 
DeviceTypesEnum deviceType - GetOeviceType( ) ; 
context. Response. ContentType - 

GetMimeType(deviceType) : 
string xsltFile - GetXsltFi le(deviceType) : 

//All XML will be loaded into an XmlTextReader 

//stream for optimal performance 

XmlTextReader reader = GetXml Readert ) ; 

wri ter . Write (DoTransf ormati on ( reader .xsl tFi 1 e . 
deviceType) + "<!-• Device: " + 
deviceType. ToString( ) + " -->"): 

I 



Listing 3 The RenderO method is called when you instantiate the 
MultiDeviceTransform control. The RenderO method then calls 
several other methods within the class to determine the device 
type, XML source, and XSLT stylesheet to use. 



1 

1 

You need to override the control's RenderO method once you 
define the MultiDeviceTransform server control's different proper- 
ties and methods (see Listing 3). Overriding the RenderO method 
enables you to add whatever functionality you'd like into the control 
and write out a response to the calling ASP.NET page by using the 
HtmlTextWriter class's Write() method. 

This code relies on several private methods within the 
MultiDeviceTransform class to perform tasks such as detecting the 
calling device, determining the proper MIME type to set, determin- 
ing which XSLT stylesheet to use, and performing the actual 
transformation. The control ensures optimal performance by using 
the XmlTextReader class to read the XML data source, regardless of 
the source type (file, DataSet, XmlDocument, and so on). The 
XmlTextReadei provides a forward-only stream of XML tokens 
that the control can read quickly and efficiently with minimal 
memory consumption. 

Determining Device Type 

Although I won't cover all the methods called within the RenderO 
method, the GetDeviceTypeO and DoTransformation() methods are 

' XML • Categorize Different Devices Using the ^ 
device.config File 



Listing 4 The device.config file allows you to categorize different 
devices by type. Categories include up-level, down-level, PDA, 
and WML. This file is read from within the GetDeviceTypeO 
method using the XmlTextReader class. 



<?xml version="l .0" encoding-"utf-8" ?> 
<devi ceConf i g> 
<devi ceCategory 

deviceType="Upl_evel " 

> 

<! - - i ncl udeNewVersi ons allows anything 
greater than or equal to the 
deviceVersion attribute value to be 
included--) 

<device devi ceStri ng=" i e" 
devi ceVersi on="4" 
i ncl udeNewVersi on s=" true" 

/> 

</devi ceCategory> 

<devi ceCategory 

deviceType="Downl_evel "> 

<devi ce devi ceStri ng=" net scape" 

/> 

<device deviceString="opera" /> 
<device deviceString="ie" 
deviceVersion="3" 

/> 

</deviceCategory> 

<devi ceCategory deviceType-" PDA" > 
<device deviceString-"pie" /> 
<device devi ceKeyword-"el aine" /> 

</devi ceCategory> 

<devi ceCategory devi ceType="WML"> 
<devi ce 

devi ce Keyword-" up. browser" 

/> 

</devi ceCategory> 
</devi ceConf i g> 
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Work With Multiple Devices 



worth examining closer. The GetDevice- 
Type() method leverages the machine.config 
file installed with the .NET SDK, which 
contains several device and browser defini- 
tions similar to those found in the old 
browscap.ini file used with ASP. 

In addition to reading from this file, the 



control also reads from a custom file named 
device.config. This file allows you to catego- 
rize specific devices as being part of the up- 
level, down-level, PDA, or WML categories 
discussed earlier by adding a deviceType at- 
tribute. The deviceType attribute values must 
match up with members defined in the 



DeviceTypesEnum enumeration shown ear- 
lier. You specify the path to the device.config 
file in the control code contained within the 
calling ASP.NET page (shown in bold): 

<wc :Mul ti Devi ceTransf orm i d=" trans" 
runat="server" 



C 1H 



private string DoTransformati on ( Xml TextReader 

reader, string xsltPath. 

DeviceTypesEnum deviceType) ( 
Stri ngBui 1 der sb = new Stri ngBui 1 der ( ) ; 
StringWriter sw = new StringWriter(sb) ; 
XPathDocument xDoc = null; 
XslTransform xsltTrans - new Xsl Transf orm( ) ; 
Xsl tArgumentLi st args = 

new Xsl tArgumentLi st( ) ; 

if (xsltPath — String. Empty) I 

return "No XSLT File found that can be " + 
"used for device: " + 
deviceType. ToString( ) : 

) 

//Load XSLT style sheet 



try I 

xDoc = new XPathDocument(reader) ; 
args = GetParamArgs(deviceType) ; 
xsltTrans. Load (xsltPath) ; 
xsltTrans .Transf ormtxDoc , args , sw) ; 

1 

catch (Exception e) 1 

return "Error in transformation: " 
e. Message: 

I 

finally ( 
sw.Close( ) : 

if (reader != null) reader. Closet ) ; 

) 

return sb.ToString( ) ; 



Listing 5 The DoTransformationO method accepts the XML source to transform in the form of an XmlTextReader, the path to the 
XSLT stylesheet to use, and the type of device being targeted. The method then uses classes in the System. Xml assembly to 
perform the XML transformation. 
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Property 


Description 


XmlFileSource 


A string representing the path of the XML document to use in the transformation. This can be static or dynamically 
generated XML (from a SQL 2000 HTTP query or an ASP.NET page, for example). 


XmlDocumentSource 


An XmlDocument object containing the XML to use in the transformation. 


XmlReaderSource 


An XmlTextReader object containing the XML to use in the transformation. 


Xm tSql Expl icitSource 


A string representing the SQL Server 2000 EXPLICIT stored procedure to use for the XML source as well as 
parameters (for example, EXEC sp_GetXML 2,'bob'). 


XmlSqIExplicitCommand 


A SqICommand object filled with the SQL Server 2000 EXPLICIT query or stored procedure to use as well as 
necessary parameters. 


ConnectionString 


A string containing the connection string used to access the SQL Server 2000 database. 


Debug 


A Boolean switch used when debug information about the calling device needs to be returned from the control. 


XmlDataSetSource 


A DataSet object containing the XML to be used in the transformation. 


DeviceConfigFile 


The path to the device.config file used to mark up different devices. 


CancelTransform 


A Boolean that causes the Render)) method to return an empty string when true. 


XsltDownBrowser 


The path to the XSLT stylesheet targeting down-level browsers. 


XsltUpBrowser 


The path to the XSLT stylesheet targeting up-level (IE4+) browsers. 


XsltPda 


The path to the XSLT stylesheet targeting PDA devices. 


XsltWml 


The path to the XSLT stylesheet targeting WML devices. 


XsltDownBrowserParams 


An XsltArgumentList object containing parameters passed to the down-level browser XSLT stylesheet. 


XsltUpBrowserParams 


An XsltArgumentList object containing parameters passed to the up-level browser XSLT stylesheet. 


XsltPdaParams 


An XsltArgumentList object containing parameters passed to the PDA XSLT stylesheet. 


XsltWmlParams 


An XsltArgumentList object containing parameters passed to the WML XSLT stylesheet. 



Table 2 Explore the MultiDeviceTransform Server Control's Properties. The MultiDeviceTransform control has several different 
properties you can use to pass the control, the XML source document to transform, the XSLT stylesheet to use for specific devices, 
and several other properties used for configuration and database connection information. The properties let less experienced ASP.NET 
developers target different devices while still offering advanced functionality for more skilled programmers. 



DeviceConfigFile-"device.config" 

Xml FileSource="XML/courses.xml " 
XSLTWML-"XSLT/Courses/ 

states-courses_wml .xslt" 
XSLTUpBrowser="XSLT/Courses/ 

states -coursesUp.xslt" 
XSLTDownBrowser="XSLT/Courses/ 

statesDown . xsl t "> 
XSLTPDA = "XSLT/Courses/ 

states -courses_pda . xsl t" 
</wc:MultiDeviceTransform> 

The device.config file is a simple XML docu- 
ment that organizes different devices and 
provides a mechanism for adding keyword 
strings found in device HTTP headers; for 
example, the Palm.Net proxy (used with 
Palm wireless devices) can return the text 
"elaine", which the server control can detect 
if you add a deviceKeyword attribute (shown 
in bold in Listing 4). You can categorize 
more common device definitions contained 
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in the machine.config file, such as those for 
IE and Netscape, by adding deviceString 
and deviceVersion attributes. The Multi- 
DeviceTransform control compares these 
attribute values against those returned by 
the HttpBrowserCapabilities object's Type 
and Version properties (see Listing 4). 

Although the optimal solution for detect- 
ing calling devices is to work with consistendy 
updated device listings in the machine.config 
file, the deviceKeyword attribute is useful in 
situations where you know specific keywords 
in the device headers but don't know all the 
possible HTTP_USER_AGENT strings sent 
by different device versions. 

The GetDeviceType() method (down- 
load Listing A) parses the device.config file 
using an XmlTextReader object and com- 
pares values found in the file to property 
values exposed by the HttpBrowserCapa- 
bilities class (which obtains device type in- 
formation from the machine.config file). 



You gain access to this object through the 
Request object associated with the current 
context. Listing 2 shows how you can access 
the current Web server context from within 
the control. 

If the deviceType and/or deviceVersion 
attribute values within the device.config file 
don't match up with any of the property 
values exposed by the HttpBrowserCapa- 
bilities class, the control compares the device- 
Keyword attribute values (if any exist) against 
the HTTP_USER_AGENT string. The 
control accesses this string value through the 
Request object's Server Variables collection. 
As it performs these different comparisons, 
any matches cause the string value found in 
the deviceType attribute to be converted to 
a DeviceTypesEnum member value using 
the TypeDescriptor class's ConvertFrom- 
StringO method. The control then returns 
the proper enumeration member value spe- 
cific to the calling device to the RenderQ 
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method, which uses the value to get the MIME type and XSLT 
stylesheet cottesponding to the calling device. 

Once you detetmine the propet MIME type and XSLT file fot 
the calling device (through calling other private methods found in 
the control), the Renderf) method calls the DoTransformation() 
method and passes the XmlTextReader containing the XML 
source, the path to the XSLT fde, and the DeviceTypesEnum 
member value as arguments. This method loads the XmlTextReader 
stream into an XPathDocument class and instantiates an 
XslTransform class as well. The DoTransformation() method 
then uses the DeviceTypesEnum value passed into the method to 
determine dynamically which XsltArgumentList (if any) passed 
into the control from the ASP.NET page it should use as a source 
for parameters passed into the XSLT stylesheet. Once the correct 
XsltArgumentList is determined, the DoTransformationO method 
calls the XslTransform class's Transform() method and returns the 
result to the Render() method, which then writes out the result to 
the calling device (see Listing 5). 

The MultiDeviceTransform control has many more features. 
You can pass SqlCommand and XsltArgumentList objects into the 
control programmatically; you can use different XML data sources 
such as XmlDocuments, DataSets, and XmlTextReaders; and you 
can leverage several SQL Server 2000 XML features including 
EXPLICIT queries. VSM 
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Delve Into Delegates 



Delegates do much more than simple function pointers. Find out how to use — 
and not use — these powerful constructs. 



Technology Toolbox 

J VB.NET 

^ C# 

□ SQLServer 

□ ASP.NET 

□ XML 

□ VB6 



Resources 



J 



• VS.NET language enhance- 
ments: http://msdn. microsoft, 
com/vstudio/nextgen/ 
technology/langdefault.asp 

• Delegates and function 
pointers: 

• "Handle Events With 

.NET Delegates" by Richard 
Grimes [Visual Basic 
Programmer's Journal July 
2001, Visual C++ Developers 
Journal section] 

• "Break API Barriers" by 
Robert Teixeira [Visual 
Basic Programmer's 
Journal August 2001] 

• Black Belt Programming, 
"Provide Pointers to Class 
Functions," by Matthew 
Curland [Visual Basic 
Programmer's Journal 
August 2001] 

• Intermediate Language |IL): 
"Is Your Code Safe?" by 
Dan Fergus [Visual Basic 
Programmer's Journal 

May 2001] 



I f you've written in C++, you're familiar with the 
I concept of a junction pointer — a variable that stores 
a function's address. This variable allows C++ code to 
call the function without knowing its name, who 
wrote it, or where it lives. In fact, the same C++ code 
can call different functions without being rewritten 
simply by changing the function pointer value while 
the program runs. 

A common application of function pointers is the 
callback Junction. In C++, if a subroutine needs to 
notify its caller about an interesting event, it takes a 
function pointer as a parameter. When the interest- 
ing event occurs, it calls the function whose address is 
stored in the function pointer. This function is the 
callback function. Note that the callback function 
can be different each time the subroutine executes; 
the caller simply must pass a different function pointer 
as the argument to the subroutine. The subroutine 
doesn't need to know anything about the callback 
function the function pointer refers to, such as the 
module it lives in, its name, or even rhe language it 
was written in. 

Using callback functions in C# differs from using 
them in C++, not to mention Visual Basic (see the 
sidebar, "Use Callback Functions in VB"). C# offers 
delegates that replace the function pointers used by 
C++ and VB. One of the most common misper- 



by Steve Lardieri 

ceptions among C++ developers learning C# is that 
delegates are "just like function pointers." Although 
C# delegates serve the same purpose as C++ function 
pointers, they represent a significant leap forward in 
functionality. At the same time, delegates are objects 
in their own right, so C++ programmers treating 
delegates as pointers make some common mistakes. 
Delegates are essential to Microsoft's .NET technol- 
ogy — the .NET Framework's class library uses them 
for any kind of callback function, such as user- 
interface event handlers. 

I'll show you how delegates work and highlight the 
pitfalls for C++ developers making the transition to 
CM. You'll see how to take advantage of three impor- 
tant features: uniform syntax for invoking static and 
instance methods, multicasting, and safe connection of 
callback functions for event handlers. In the process, 
you'll create a delegate, assign it to a variable, invoke the 
method or methods the delegate refers to, and explore 
a delegate's properties and methods. But first, I'll 
compare C++ function pointers to C# delegates. 

Function Pointers vs. Delegates 

C++ function pointers are only self-sufficient when 
referring to global functions or sratic class methods. 
Function pointers that refer to instance methods — 
functions that take a hidden "this" parameter — can 



Use Callback Functions in VB 



Visual Basic developers can use the AddressOf keyword to obtain function pointers for their own functions 
and subroutines. Although VB can't actually call a function using a function pointer (as C++ can), it can pass 
the function pointer to code written in C++. The C++ code can then call the VB function or subroutine using 
the function pointer. This proves useful for VB developers who want to use C++ APIs that require callback 
function pointers such as EnumWindowsQ. 
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point only to the methods within one particular class. And each time 
you call through that function pointer, you must also specify the 
name of (or a pointer to) a specific "this" object. 

Also, function pointers can point only to one function at a time. 
In contrast, you can use the same C# delegate to invoke a static 
method of any class or an instance method of any object, as long as 
the method's signature matches the delegate type. (C# has no global 
functions.) When referring to instance methods, delegates remem- 
ber the appropriate "this" reference to use, so you don't need to 
specify it each time you use the delegate. You can also use a single 
C# delegate to invoke several methods at a time using a technology 
called multicasting. 

How can a delegate invoke multiple methods simultaneously? 
Simple: Delegates are class objects, not merely simple variables like 
C++ function pointers. Delegates have properties and methods, just 
like any other object. And different delegate classes — even if they 
have the same signatures — are considered different types. 

Now I'll show you how to create a delegate, assign it to a variable, 
and invoke the method(s) the delegate refers to. Define a delegate 
type named Del (see Listing 1): 

publ i c del egate 

void Del (int x) ; 

When the Microsoft C# compiler processes this line of code, it 
creates a new class named Del that derives from System. Multi- 
castDelegate, a base class that lives inside the .NET Common 
Language Runtime (CLR) engine. You can then declare variables 
of type Del: 

Del delA: 
Del delB; 

These variables are object references. You must create instances 
of Del using the new keyword, as you do with any other class: 

delA = new Del (myObj . InstMeth) ; 
delB = new Del (MyCl ass . StatMeth ) ; 

Del's constructor takes the name of a method qualified by the 
object (for an instance method) or class (for a static method) 
where the method lives. You should note that the delegate variable 
itself refers to the newly constructed Del object, not directly to 
the method. 

C++ developers often try to use this syntax: 

Del delC = someObj .SomeMeth; // No! 

This won't work, however, because the delegate variable, delC, 
needs to refer to an instance of the Del delegate class. It is this 
instance of Del that refers to someObj.SomefvIeth(). 

Once you create a delegate and assign it to a variable, you can 
invoke the method or methods the delegate refers to by using the 
delegate variable name as if it were a method name. For instance, the 
Main() method declares two delegate variables, delA and delB, then 
invokes the actual methods those delegates refer to (see Listing 1): 

delA (99); 

// calls: myObj . InstMeth (99); 



/ C# • Use Delegates to Invoke Methods A 

. — 

public delegate void Del (int x): 

class MyClass 

{ 

public static 

void StatMeth (int x) ( 1 
publ i c 

void InstMeth (int x) I ) 

public static 

void Main (string [] args) 

1 

MyClass myObj - new MyClass (): 

Del delA - new Del (myObj . InstMeth) ; 

Del delB = new Del (MyCl ass . StatMeth ) ; 

delA (99); 

// calls: myObj. InstMeth (99); 

delB (99); 

// calls: MyClass. StatMeth (99); 

Del versatile: 

versatile «= new Del (MyCl ass . StatMeth ) ; 
versatile (1234): 

versatile - new Del (myObj . InstMeth) : 
versatile (1234); // same syntax as above 
1 // end of Main( ) 
) // end of MyClass 

Listing 1 The MainO method declares two delegate variables, 
delA and delB, then invokes the actual methods those delegates 
refer to. Note that the syntax for invoking instance methods is 
identical to the syntax for invoking static methods, as you can 
see from the versatile delegate variable. 

delB (99); 

// calls: MyClass. StatMeth (99): 

Notice that when you invoke delA, which refers to an instance 
method, you don't need to specify which instance to use. This is 
because the delegate itself stores a copy of the myObj reference when 
you create it with the new operator and uses that reference as the 
"this" reference when invoking the method. By the time delA gets 
invoked, the myObj variable might even have gone out of scope, but 
it doesn't matter because the delegate object still contains that 
reference. This is significant because you can invoke a delegate 
without knowing what object it refers to. In addition, the object the 
delegate refers to won't be garbage-collected as long as the delegate 
still refers to it. 

Another fact to note: The syntax for invoking instance methods 
is identical to the syntax for invoking static methods (see the versatile 
delegate variable at the end of Listing 1). 

Have Properties, Will Travel 

Again, all this works because delegates are objects. Like other class 
objects, delegates have properties — the two most important are 
Method and Target. Method is simply a reference to the method to 
invoke. It is stored as a Methodlnfo object, which uses the CLR's 
reflection feature: the ability to make information about the executing 
C# application available to the application itself (download the 
sidebar, "Reflections on Reflection," from the VSM Web site; see the 
Go Online box for details). Target is an object reference the delegate 
uses as the "this" reference when it invokes the method. If the delegate 
refers to a static method, Target is Null. 
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Delegates also have several interesting 
methods. The Invoke() method, which all 
delegates inherit from System. Delegate, ex- 
ecutes the method the delegate refers to on the 
target object, if any. However, the C# com- 
piler doesn't let you call Invoke() directly: 

someDel . Invoke (123); // No! 

Instead, use the delegate variable name as 
if it were a method name: 

someDel (123); // OK 

The C# compiler recognizes this special 
syntax because it knows someDel is a vari- 
able whose type is a delegate. The compiler 
then generates Intermediate Language (IL) 
code to call the Delr.Invoke (System.Int32) 
function (see Resources for information 
about IL). 




legates are 
class objects, 
wt simple 
rariables like 
function 
pointers. 




Besides Invoke(), delegates also feature a 
DynamicInvoke() method that allows late- 
bound method calls. The advantage of late 
binding is you don't need to know the 
delegate's signature until run time. Then 
you can construct an appropriate argument 
list dynamically by creating an array of ob- 
jects. The disadvantage of late binding: The 
method call itself involves considerably more 
overhead because the runtime engine must 
use reflection information to invoke the 
method. For this reason, .NET runtime 
engines rargeringembcddcd devices — where 
space and CPU cycles are at a premium — 
might not implement DynamicInvoke(). 

I'll show you an example involving 



DynamicInvoke(), a public method of 
System. Delegate. In this code, you can call 
Mylnv() with delegates whose signatures 
take any number of integer parameters: 

void MylnvtDelegate del. int count) 
I 

objectn arglist = new inttcount]; 
// fill in argl i st here. . . 
del .Dynamiclnvoke (arglist); 



Notice that Mylnv() uses polymorphism to 
accept any kind of delegate as a parameter 
because all delegate types have System. - 
Delegate as a base class. Mylnv() uses the 
count parameter to decide how many inte- 
gers to pass to the delegate method. You 
might use Mylnv() like this: 

public delegate 

void DelOne (int x) : 
public delegate 

void Del Two (int x, int y); 
DelOne one = 

new DelOne (myCl ass .MethOne ) ; 
Del Two two = 

new DelTwo ( myCl ass .MethTwo ) : 
Mylnv (delOne, 1); 
Mylnv (delTwo. 2); 

Internally, DynamicInvoke() calls Dy- 
namicInvokeImpl(), which is a protected, 
virtual method of System. Delegate. Spe- 
cific, compiler-generated delegate classes, 
such as DelOne and DelTwo, can override 
DynamicInvokelmplO to check the validity 
of the argument list. Finally, Dynamic- 
InvokelmplO calls Methodlnfo.InvokeO, 
utilizing reflection to make the runtime 
engine execute the method. 

Form a New Delegate 

Let's delve deeper into multicasting, a tech- 
nology that lets a single C# delegate invoke 
several methods at a time. When you define 
new delegate types, the compiler generates 
classes that derive from System. Multicast- 
Delegate (a subclass of System. Delegate), 
which also has some methods of interest. 
For instance, the CombineO method allows 
you to join the invocation lists of two exist- 
ing delegates to form a new delegate that 
executes all the methods in the list when it's 
invoked. In C#, you access the CombineO 
method using the + or += operator: 

Del delA. delB; 



delA += delB; 

// delA « System. Mul ti castDel egate . 
// Combine (delA. delB): 

You can use CombineO only to merge del- 
egates of the same type. Currently, the del- 
egate rype must have a signature with a void 
return type, although this might change by 
the time VS.NET ships. 

Recall that an individual delegate object 
has a single Method property and a single 
Target property. Multicast delegates have a 
simple linked list of individual delegate ob- 
jects, called the invocation list. Invoking the 
combined delegate calls all the methods 
specified by each delegate in the list. The 
invocation list for a nonmulticast delegate 
has one element: itself. 

The CombineO method doesn't filter 
out redundancies. For instance, suppose 
you have two delegates, delA and delB, and 
you combine them like this: 

Del delA = new MyDel (objA.methA) ; 
Del delB = new MyDel ( obj B . met hB ) ; 
Del delC - delA; 
delC += delB; 
delC += delA; 

Invoking delCcallsobjA.methA(), then objB.- 
methBO, and finally objA.methAO again. 

As you might expect, System.MuIticast- 
Delegate also has a Remove() method. Again, 
you don't call this method directly; the C# 
compiler does it for you when you use the — 
or— = operator. The Remove() method walks 
the invocation list of the first delegate back- 
ward, using a pattern-matching algorithm 
until it finds a contiguous pattern that 
matches the invocation list of the second 
delegate exactly. For instance, if delA, delB, 
delX, delY, and delZ are all delegates of the 
same type, then this code: 

delA - 

delX + delY + delY + delZ + 

delY + delY + delX + delY; 
delB = delY + delY; 
delA •= delB: 

results in: 

del A == 

delX + delY + delY + delZ + 
delX + delY 

Notice the second delY pair got removed — 
not the first pair, nor the lone delY at the end. 
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Classes can contain a special kind of multicast delegate called an 
event. Use the event keywotd when you declare public delegate 
fields — not delegate types, but variables of those types. It alters the 
usual behavior of the public keyword so only the += and-= operators 
are actually public. All the delegate's other properties and methods 
remain off-limits to code outside the class where the variable is 
declared. You'll find this altered behavior useful for classes that must 
let their clients register callback functions without worrying about 
a client corrupting or inspecting the delegate's invocation list 
surreptitiously. For instance, many Microsoft classes that imple- 
ment UI components expose delegate fields declared as events to 
allow client applications to attach their event handlers to specific UI 
objects. The delegate types for these Microsoft-defined events 
usually have a standard signature — a referrer object, followed by an 
EventArgs parameter — but C# allows you to use any delegate type 
to define events for your own classes. 

In this example, I create a class called MyControl. Inside MyControl 
is a custom delegate type, E, and a field of that type, myEvent: 

public class MyControl 

( 

publ i c del egate 

void E tint x); 

// defines type 
public event E myEvent; 

// declares variable 
publ 1 c MyControl ( ) 
1 

myEvent = nul 1 ; // OK 

1 

I 

The code inside MyControl can modify myEvent. But because 
I declared myEvent using the event keyword, a client application 
that uses MyControl can access myEvent only through the += 
and -= operators: 

public class ClientApp 
{ 

public static 

void SomeHandler (int x) ( I 
public static 

void Main (string [] args) 

I 

MyControl c = 

new MyControl ( ) ; 
MyControl. E myHandler = new 

MyControl. E (SomeHandler); 
c. myEvent - myHandler; // No! 
c. myEvent += myHandler; // OK 

1 

I 

Notice the delegate type E defined in MyControl is completely 
public; the ClientApp class can declare variables and instantiate 
objects of type MyControl.E legally. Only the field MyCon- 
trol. myEvent is restricted. 

You can also have events that are properties rather than fields. In 



C#, a property is a class member that looks like a field but allows a 
class to take specific action when a client accesses the member. 
However, unlike normal C# properties, event properties don't have 
"get" and "set" functions. Instead, they have functions called "add" 
and "remove" that are invoked when a client uses the += and -= 
operators. Here's the MyControl class rewritten to make myEvent 
a property rather than a field: 

public class MyControl 
I 

private E myEventlnternal : 
publ i c event E myEvent 

( 

add 
I 

myEventlnternal value: 

1 

remove 
I 

myEventlnternal -= value; 

1 

1 

1 

Note two important points. First, the code in ClientApp doesn't 
need to change. Client classes don't need to know whether an event 
is a field or a property. Second, MyControl still needs someplace to 
store the actual event delegate. In this case, however, it's a private 
delegate field rather than a public event field. Finally, remember 
that even though this example is trivial, a real-world add or remove 
function could execute a complex sequence of instructions, depend- 
ing on the class design. 

Fluency with delegates is an essential skill for a .NET developer. 
Now you've seen how delegates work, how to use delegates to receive 
UI events from Microsoft's framework classes, and how to incorpo- 
rate delegates into your own classes. Clearly, delegates are much 
more than just function pointers, vsm 
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Use COM+ Services 
With .NET Components 



Attributes and dynamic registration make it simple to create 
managed classes that use C0M+ services. 



by Alan Gordon 
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#1 

ontrary to popular opinion, the .NET Frame- 
^^work doesn't replace COM+. You still need 
COM+ services — such as distributed transactions, 
object pooling, Just In Time Activation (JITA), syn- 
chronization, and queued components — to build 
enterprise-class, distributed applications on the Win- 
dows platform. In this article, you'll learn how to 
create and deploy a serviced component, which is 
Microsoft's name for a .NET component that uses 
the COM+ services. 

Creating a serviced component is simple. First, 
your class must inherit from the ServicedComponent 
base class in the System. EnterpriseServices namespace. 
Next, you add attributes to your class that specify 
which COM+ services your class will use. You then 
add attributes to your assembly, which configure the 
COM+ application your class will reside in. 

When you create an instance of your serviced 
component from a managed client, the Common 
Language Runtime (CLR) creates a COM+ applica- 
tion for your class (if one doesn't exist already) and 
configures it according to the attributes you specify in 
your assembly. The CLR then configures each class in 
the assembly using the class-level attributes you've 
specified. Alternatively, you can use the .NET Ser- 
vices Installation Tool (regsvcs.exe) in the .NET 
Framework SDK, which creates a COM+ application 
and configures your .NET component in advance. 

It sounds simple, but the devil's in the details, so 
let's explore serviced components further. First I'll 
show you how to create a serviced component, then 
how to start and commit a distributed transaction 
with serviced components. You'll learn to use con- 
nection pooling to combat the high latency associated 
with creating a database connection. Then you'll 
configure the COM+ application your serviced com- 
ponents will reside in, create a client, and use the 
serviced component from that client. Finally, I'll 
show you two ways to access your serviced compo- 
nent through HTTP using Web Services. 

This C# code shows how to create a serviced 



component that uses COM+ transactions, object 
pooling, and a construction string: 

nnamespace SCArticle 

I 

using System; 

using Microsoft.EnterpriseServices: 

[ObjectPool ing( 

Enabl ed-true ,Mi nPool Si ze=2 . 

MaxPoolSize=10, 

CreationTimeout-3000)] 
[Transacti on( 

Transacti onOpti on . Requi red)] 

[Cons tructi on Enabl ed( true, Def a ul t- 
"user i d=sa : password-; i ni ti al 
catal og=pubs ;data source=localhost")] 
public class Book : 

Servi cedComponent 

I 



Notice this class inherits from the ServicedComponent 
base class. Also notice I use the ObjectPooling, Trans- 
action, and ConstructionEnabled attributes from the 
Microsoft.EnterpriseServices namespace. For the 
ObjectPooling attribute, I specified a minimum and 
maximum pool size and a creation timeout (see 
Resources for more information on object pooling). 
If you don't specify these values, the CLR configures 
your class with the standard COM+ default values of 
0,1048576, and 60000. The TransactionOption.Re- 
quired parameter on the Transaction attribute is 
optional because Required is the default. So you 
could write this as [Transaction] instead. I prefer the 
explicit approach shown here because it's more self- 
documenting. The ConstructionEnabled attribute 
allows you to use COM+ construction strings to pass 
a string to a configured component. In this case, I use 
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Here's What You Get 

Download the code for this article, and you get both C# and 
VB.NET versions of: 

• A serviced component, Book, that uses the SQL Server Pubs 
database; its methods allow you to create, modify, or delete a 
book. 

• A Windows Forms client that uses the serviced component. 

• A Web Service wrapper for the serviced component that lets 
you access it through HTTP. 

• All code listings and tables. 

See the Go Online box for instructions on downloading, and see 
the download's readme file for installation and usage details. 



the construction string to store the database connection string for 
my component, and I've specified a default value for the string, 
which points to the Pubs sample database on the local machine. 

Many COM+ attributes depend on one another. For instance, 
if you set the Transaction attribute to Supported, Required, or 
Requires New, you must also set the Synchronization attribute to 
Required and enable JITA. Fortunately, the .NET runtime knows 
about these dependencies and sets the appropriate attributes for 
you. In fact, my own experiments show that once you set the 
Transaction attribute to Supported, Required, or Requires New, 
the .NET runtime ignores any settings you specify for the Synchro- 
nization or JITA attributes. The Synchronization and JITA at- 
tributes are set automatically to Required and Enabled, respectively. 
See the help on the Microsoft.EnterpriseServices namespace in the 
.NET Framework Reference to learn more about the COM+- 
related attributes you can apply to a class (see Table 1). If you don't 
specify a value for one of the attributes listed in Table 1, the CLR 
uses a default value for that attribute. 

If you use object pooling — as this class does — you might want 
to override the Activate and Deactivate methods in the Serviced- 
Component base class. The Activate method allows you to initialize 
an instance of your class when it's activated from the object pool . 
The Deactivate method allows you to free any resources your class 
uses when it returns to the object pool. If you're an experienced 
COM+ programmer, you should recognize these methods from the 
IObjectControI interface. The ServicedComponent class contains 
implementations of the IObjectControI interface's methods you 
can override — Activate, Deactivate, and CanBePooled: 

public class Book : ServicedComponent 
I 

public Book( ) 

I 

I 

override public void 

override public void ActivateO 

{ 

//... initialize the object 
I 

override public void DeactivateO 
I 

//... clean up after the object 

I 



override public bool CanBePool ed( ) 
I 

return true; 

I 

1 

Serviced Components that use construction strings must override 
the Construct method in the ServicedComponent base class to 
receive the construction string: 

public class Book : ServicedComponent 

I 

public BookO 

I 

I 

override public void Constructf stri ng s) 
I 

connecti onStri ng=s : 

) 

// . . . 

private string connecti onStri ng ; 

I 

Starting and committing (or aborting) a distributed transaction 
with serviced components works the same way it does in Visual 
Studio 6.0. If a component marked as Required or Requires New 
makes a call to a resource manager, COM+ starts a Distributed 
Transaction Coordinator (DTC) transaction on behalf of the 
component and enlists the resource manager in the transaction. 
When the component completes its work, it calls SetComplete on 
its object context if it votes to commit the transaction, andSetAbort 
if it votes to roll back the transaction. 

A serviced component can access its object context using the 
ContextUtil class (download Tables 2 and 3 from the KSMWeb site; 
see the Go Online box for details). This class contains all the 
functionality found in the IObjectContext and IContextState inter- 
faces you use today with COM+. All these methods and properties are 
static, so you use the ContextUtil class without creating an instance. 

Check out how a method in a serviced component typically uses 
the ContextUtil class (download Listing 1). This method, called 
DeleteBook, contains ADO.NET code to delete a book from the 
SQL Server Pubs database using a stored procedure included with this 
article's code (download it from the VSA/Web site; see the sidebar, 
"Here's What You Get," and the Go Online box for details). Notice 
you execute the database operations in a "try" block. If the database 
operations complete successfully, call the static SetComplete method 
on the ContextUtil class. If an error occurs and the control flow jumps 
to the "catch" block, call the SetAbort method. Use the "Finally" 
clause, which is executed whether an error occurs or not, to ensure you 
close your database connection before the method returns: 

try 1 

conn.Opent ) ; 

cmdTitle. ExecuteNonQuery( ) ; 
ContextUtil. SetCompl ete( ) ; 

I 

catch {Exception err)( 
ContextUtil . SetAbortt ) ; 
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throw err; 

I 

finally j 

if (conn. State == 
Connect ionSt ate. Open) 
conn . CI ose( ) : 

I 

You can avoid using the ContextUtil class if you apply the 
AutoComplete attribute to the DeleteBook method, in which case 
the COM+ runtime calls SetComplete on the object's context 
automatically if the method returns without throwing an error; if 
the method throws an error, the runtime calls SetAbort. In this case, 
you don't need to use the ContextUtil class, and the DeleteBook 
method's definition looks a little different (download Listing 2). 
Microsoft recommends you use the AutoComplete attribute in- 



stead of the ContextUtil class because you need to write fewer lines 
of code, reducing your chances for error. 

All the methods in our serviced component open a database 
connection, perform some operations, then close the connection 
immediately. This is the most scalable way to use database connec- 
tions in a multiuser environment. However, unless you use database 
connection pooling, this approach suffers from high latency because 
creating a database connection is usually a slow operation. Fortu- 
nately, the OLE DB (previously called ADO in beta 1) data provider 
in the System.Data.OleDb namespace and the native SQL Server 
provider in the System. Data. SqlClient namespace both support 
database connection pooling. 

Create a COM+ Application 

The Microsoft.EnterpriseServices namespace contains a set of 
application-level attributes you can use to configure the COM+ 



Attribute Name 


Purpose 


Default Value ^ 


Transaction 


Specifies C0M+ (distributed) transaction support. 

Possible values reside in the TransactionOption 

enumeration: Ignored, None, Required, RequiresNew, Supported. 


TransactionOption. Ignored. 


Synchronization 


Specifies C0M+ concurrency support. Possible values reside in 
the SynchronizationOption enumeration: None, Required, 
RequiresNew, Supported. 


SynchronizationOption. Ignored. 
(SynchronizationOption. Required if the 
component uses distributed transactions.) 


JustlnTimeActivation 


Specifies Just In Time Activation (JITA) support. 


False. (True if the component uses 
distributed transactions.) 


ObjectPooling 


Specifies support for object pooling. Properties on this attribute 
allow you to configure the minimum and maximum size of the 
pool and the creation timeout. 


False. 


AutoComplete 


Allows you to make a method = "auto complete," meaning 
C0M+ calls SetComplete if the method returns without S_0K, 
anu oeiMuort it me metnou returns an error. 


False. 


SecurityRole 


Adds a role to a C0M+ application and specifies that a class 
requires users to be in the role. 


No default roles are added. 


MustRunlnClientContext 


Specifies that a class must run in the same context as its client. 


False. 


ConstructionsEnabled 


Specifies that a class supports construction strings. Use the 
default property of this attribute to specify an initial value for 
this construction string. 


False. 


EventTrackingEnabled 


Specifies that a class supports events and statistics. 


False. (The documentation says the default 
for configured components is True, but my 
own experiments prove otherwise.) 


ComponentAccessControl 


Specifies whether role-based security checks are performed 
at the component level. 


False. 


LoadESalancingSupported 


Specifies whether a component supports the Component 
Load Balancing service available in Microsoft 
Application Center Server. 


False. 


Description 


Allows you to specify a description for a class that will appear 
in the component services explorer. 


No default. 


ExceptionClass 


For queued components, allows you to specify that a class 
will receive exceptions. 


No default. 


EventClass 


Specifies that a class is a C0M+ events class. Method calls 
on this class will be delivered to event subscribers instead of 
this class's implementation. 


FirelnParallel=False, 

AllowlnprocSubscribers=TruG, 

PublisherFilter=Null 



Table 1 Apply COM+ Attributes. Here's a list of the COM+-related attributes you can apply to a class. If you don't specify a value 
for one of the attributes, the CLR uses a default value. 
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application that your serviced components will reside in (download 
Table 4). Apply these attributes to the assembly that'll contain your 
serviced component: 

[assembl y: Appl icationName( "Beta2Book_Servi cedComponent" ) ] 
[assembl y : Appl i cati onActi vationt Acti vationOption .Server ) ] 
[assembly: Descri pti on( "A C0M+ Application to test .NET 
Serviced Components")] 

Here you specify that your COM+ application will be called 
"Beta2Book_ServicedComponent" and that it will be a server 
application (that is, it will run in its own process). You can add this 
code to the same file as your serviced component, but for a better 
approach, create a separate assembly header file that you compile 
into your assembly. VS.NET creates an assembly header file, 
assemblyinfo.es, whenever you create a new project. 

You must also give your serviced component assemblies a strong 
name. The CLR uses the strong name to generate GUIDs for your 
component when you register it with COM+ . To add a strong name 
to your assembly, run the Strong Name Tool (sn.exe) to create a key 
pair, place the key pair in the same directory as your project, and add 
this line to your assembly info file: 

[assembly: Assembl ykeyFi 1 e(@" . A\. . Wmykey . snk" ) ] 

Once you compile your serviced component class and the assembly 
info file into an assembly, you're ready to create a client. 

You use serviced components from a client application the same 
way you'd use any other .NET class. Simply reference the assembly 
that contains the serviced component — called Book, in this case — 
and create an instance of the class using the new operator in C#: 

public void MyDel eteHandl ertobject sender, 

DataRowChangeEventArgs e) 

I 

MessageBox . Show( 

"Deleting Book: " + 
e.Row[0].ToString()) : 

try 
I 

Book aBook=new Book(): 
aBook.DeleteBook((string) 
e. Row["title_id"] ) ; 

I 

catch (Exception err){ 

MessageBox. Show( err. Message) ; 

1 

I 

You can allow the CLR to create the COM+ application for your 
serviced component using the attributes in the assembly — this is 
called dynamic registration. Or, you can use the .NET Services 
Installation Tool (regsvcs.exe) to create the application in a process 
called manual registration. The CLR configures your serviced com- 
ponent within the application according to the attributes you 
specified in your assembly. Regardless of which approach you 
choose, at runtime your client application must be able to locate the 
assembly that contains your serviced component. 
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If your assembly uses "Library" activation, you must deploy the 
assembly into the same directory as the client application or in the 
configurable private path for the client application, which you can 
specify using the client application's configuration file. Or you can 
deploy the assembly into the Global Assembly Cache (GAC) using 
the Global Assembly Cache Tool (gacutil.exe). If you use "Server" 
activation, I strongly recommend you use the GAC. With Server 
activation, your assembly runs in the DLLHost surrogate process. If 
you don't use the GAC, you need to deploy your assembly into both 
the client application's directory (or private path) and your Sys- 
tem32 directory. The deployment into System32 is necessary so the 
DLLHost process can locate the assembly. 

Integrate With Web Services 

The Windows Forms client included with the code download uses 
COM interop to talk to the serviced component, but you can also 
access your serviced component through HTTP using Web Services 
(see the sidebar, "Here's What You Get," and the Go Online box for 
details). You can do this in two ways. First, you can wrap the serviced 
component in a Web Service. Second, you can use the serviced 
component as the implementation class for a Web Service. 

To implement the first option, create an AS MX file (download 
Listing 3), add a stub implementation for each method the 
serviced component supports, and forward each method call to the 
component: 

[WebMethod] 

public DataSet GetBooksO 
I 

Book aBook-new Book(); 
return aBook.GetBooks( ) : 

I 

You also must create a virtual directory that points to the physical 
directory containing the ASMX file. Beta 2 requires you to reference 
System. EnterpriseServices from any client of a serviced component, 
so you must add this web. config file to your virtual directory because 
the ASP.NET runtime doesn't reference the System. Enter- 
priseServices assembly by default when it compiles a Web Service: 

<conf i gurati on> 
<system.web> 
<compi 1 ati on> 
<assembl i es> 

<add assembly="System. Enterpri seServi ces " /> 
</assembl ies> 
</compilation> 
</system.web> 
</conf i gurati on> 

See the .NET Framework documentation for more information 
about web. config files. 

Implement the second option by adding the WebMethod at- 
tribute to each method in the serviced component: 

[WebMethod] 

public void Del eteBook( stri ng titlelD) 

I 
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II... The rest of this method is omitted for brevity 
I 

Now reference the System.Web.Services.dll assembly and add a 
using statement for the System. Web. Services namespace: 

using System. Web. Servi ces ; 

Create an ASMX file containing only a single line that directs the 
ASP.NET runtime to your serviced component: 

<%@ WebService Language="C#" Codebehind="Book.cs" 
cl ass="SCArti cle.Book"%> 

Next, create a virtual directory that points to the physical 
directory containing the ASMX file and Book.cs source file. 

Wrapping the serviced component in a Web Service (the first 
option) is probably a better approach than using the serviced 
component as the implementation class for a Web Service (the 
second option). If you go with the second option, you can't inherit 
from the WebService class in System.Web.Services because C# 
supports only single inheritance, and a serviced component class 
must inherit from the ServicedComponent base class. If you don't 
inherit from the WebService base class, you don't have access to the 
Session, Application, and Context objects. Also, if you use the 



second approach, you should use a library (in-process) application 
so your serviced component runs in the same process as IIS. vsm 
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ost flavors of Windows come with a built-in 
scheduler application, similar to Windows 
98's Task Scheduler. These general-purpose schedulers 
prove quite useful for running apps such as the 
Windows Disk Defragmenter, virus scanners, and 
other regularly scheduled system maintenance utili- 
ties. You don't get much flexibility, however, if you 
need to run apps on a variable schedule or send a 
variety of function tequests based on events that 
occur in your environment. 

For example, consider a reporting application 
such as a stock tracker that you need to run more or 
less frequently, depending on what's happening 
with stock prices and volumes. You might have an 
order-processing application that needs to run dif- 
ferent types of analyses at different times of the day. 
Or you might need to send a variable such as a 
directory name or filename each time you start the 
scheduled application. 

In this column, I'll show you how to build a task- 
scheduling component — an ActiveX DLL — that 
stores and manages its settings in the Registry, launches 
other apps, and passes parameters into those apps at 
startup. I'll also show you how to build code in the 
scheduled app to receive and interpret command-line 
parameters as well as manage multiple instances of 
itself. The code accompanying this article includes 
TaskSchedulerDLL, a reusable ActiveX DLL that 
forms the core of the scheduling engine; TestSched, 
a scheduling test app; and ClientApp, a client app 
controlled with command-line parameters. Down- 
load the code from the VSM Web site and follow 
along (see the Go Online box for details). 

TaskSchedulerDLL has methods lo load, save, 
and delete settings for scheduled apps. Its Schedule 
method checks if its scheduled tasks are due, and if so, 
launches them with optional parameters. Finally, you 



by Stan Schultes 

turn scheduling on and off completely with a 
SchedulerEnable property. 

The TestSched app provides the time base (with a 
Timer control) for TaskSchedulerDLL, and it in- 
cludes a user interface form for manipulating the 
scheduled apps' settings. TestSched also simulates its 
own workload, showing you how to build a multipur- 
pose scheduling tool. On the scheduled side, the 
ClientApp program accepts a set of command-line 
parameters that vary a simulated workload. You can 
create multiple copies of ClientApp (such as App 1 , 
App2, and so on) to test the scheduling engine. I'll 
talk about ClientApp first, then go back to Task- 
SchedulerDLL and TestSched in more detail. 

When launched, ClientApp reads its command- 
line parameters to determine what to do (download 
Listing A) and runs a simulated workload. This code 
in the frmClientMain's Form_Load routine does 
just that: 

If LoadParametersf ) Then 
BeginWork 

Else 

Unload Me 'exits 
End If 

The LoadParameters routine returns False if it detects 
the /S parameter, indicating that only a single instance 
of the application should be allowed to run at a time. 

Weigh Your Optional 
Parameters 

In addition to /S, ClientApp has two other command- 
line parameters: /I:nnn specifies the interval (in sec- 
onds) to run, and /P instructs the app to prompt before 
exiting. The ClientApp command-line parameters are 
all optional and can appear in any order or combina- 
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tion. These parameters serve only to demonstrate the task scheduler; 
you can define specific parameters for your own applications as your 
needs dictate. 

LoadParameters checks the command-line argument for each of 
the three parameters. For the /I parameter, LoadParameters grabs 
the interval value from behind the colon (the 120 in /1: 120, for 
example) , checks that it's numeric, and stores the value in a module- 
level variable that controls the length of the simulated work task: 

Case "I" 'Interval nnn in seconds 
sValue = Mid$(sParams(lParam), 3) 
If IsNumeric(sValue) Then 
mllnterval = CLng(sValue) 

Else 

mllnterval = 20 '20 sec default 

End If 

The /S parameter's presence, as I mentioned earlier, indicates 
that only one instance of the application is allowed to run at a time; 
if /S is absent, multiple copies of the app can run concurrently. This 
option is useful if the app's workload is highly variable and you 
simply need one copy of it to run at a set interval. For example, a 
maintenance application such as a file archiver might occasionally 
take a long time to run, but you want only one instance to run 
frequently. The /S parameter is immediate-acting — it causes any 
new instances of the app to exit instantly if LoadParameters finds a 
running copy using the App.PrevInstance function: 

Case "S" 'single-instance 
If App.PrevInstance Then 

'signal to exit 

LoadParameters = False 

Exit Function 
End If 

The /P parameter causes the application to prompt before 
exiting. You probably won't find this option useful by itself, but it 
helps illustrate how the /S parameter works when you use the two 
together in ClientApp. LoadParameters sets a module-level variable 
if IV is present: 

Case "P" 'prompt before exit 
mbPromptBeforeExit = True 
End Select 

When ClientApp runs, it counts up to the specified interval using 
a progress bar, then exits (showing a prompt if you passed it the /P 
parameter). You can use this simulated workload to test your task- 
scheduling engine. Your apps can perform any work you want, and 
the command-line parameters let you build flexibility into your 
scheduling interface. 

The scheduling engine itself is fueled by TaskSchedulerDLL, an 
ActiveX DLL that contains the scheduling and settings mainte- 
nance functions. You build TaskSchedulerDLL from two classes: 
TaskScheduler.cls and CProgram.cls. TaskScheduler.cls creates an 
instance of the CProgram.cls object for each scheduled app. Each 
instance of CProgram.cls exposes its program settings as properties 
of the class. 



Figure 1 Configure the Scheduler Settings. Use this form — 
accessible from TestSched's File | Schedule menu item — to control 
settings for the scheduler DLL and client applications. The 
Scheduler Enabled checkbox is a global on/off switch, and the 
Enabled checkbox controls each individual app. You set each app's 
schedule and define parameters meaningful to each client app to 
pass at startup. TaskSchedulerDLL stores the settings defined 
on this form in the Registry. 

TaskSchedulerDLL persists (stores) and maintains settings in the 
Registry under the key \HKEY_CURRENT_USER\Software\ 
VB and VBA Program Settings\Scheduler. The Settings subkey 
contains values for the SchedulerEnable flag and a comma-delimited 
list of your scheduled apps. The Registry also has keys containing the 
settings for each scheduled app you've configured. 

Set the TaskScheduler.cls Instancing property to 5-MultiUse so 
the calling application can instantiate the class. Set the CProgram.cls 
Instancing property to 1 -Private so it stays hidden within the DLL. 
This way, the calling application doesn't have direct access to the 
scheduled apps' details. The calling app obtains all access to the 
scheduled apps' settings through TaskScheduler.cls method calls, 
such as LoadApp, SaveApp, and RemoveApp. 

The primary function within the TaskSchedulerDLL compo- 
nent is the Schedule method (see Listing 1 ). You call Schedule at an 
interval of your choice, depending on the timing resolution you 
need in your applications. An interval as short as one second gives 
great control over app activation times, but it uses more system 
resources. If your timing needs are more modest, you can set the 
scheduling interval to 15 or even 30 minutes. 

Testing, Testing, 1-2-3 

Finally, I built the TestSched app as a standard EXE project. I built 
the TestSched app and the TaskSchedulerDLL together into a 
project group (TestSchedGroup.vbg), so you can debug them as a 
unit. The TestSched startup form, called frmTestMain, contains a 
Start button, a timer control, a progress bar, and a File menu. The 
File I Schedule option shows frmTestSched, which provides you 
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with the interface to manage scheduled app settings (see Figure 1). 
The TaskSchedulerDLL reads and writes all settings to the Registry, 
so the TestSched app handles no settings' storage details directly. 

The app settings you can manage through frmTestSched include 
application name, executable file path, enabled flag, command-line 
parameters, scheduled interval, and startup delay. Startup delay 
spreads out the load when you're scheduling more than one appli- 
cation by allowing a configurable delay before starting each one. 

The scheduled interval and startup delay use a code to represent 
the interval. The code is in NNT form, where NN represents the 
quantity of time and T represents the time unit. Intervals can be S, 
M, H, D, or W — seconds, minutes, hours, days, or weeks — and the 
NN quantity can be any integer value. Examples of interval codes 
include 10S, 2M, and 4H. 

The schedule settings fall into two distinct groups: immediate 
settings and configuration settings. Immediate settings include the 
SchedulerEnable flag and the individual apps' Enabled property. 
These enable flags are read from the Registry each time they're 
referenced, so any changes to the values take immediate effect. The 
configuration settings — app name, path, parameters, and intervals — 
reside in the CProgram object instances, and are read and written to 
the Registry only when the Load and Save methods are called. 

The sample version of TaskSchedulerDLL allows you to schedule 
times relative to when the TestSched program first runs. A useful 
exercise: Add the ability to run at an absolute time and interval, such 
as "every day at 10 a.m." or "every two hours on the half hour." You 
won't find this task difficult if you keep your scheduling rules simple. 

Click on TestSched's Start button to enable the main form's 

f VB6 • Drill Down to the Execution Engine Core "^N 





Listing 1 The TaskSchedulerDLL's Schedule method is the key 
routine in the scheduling process. It tracks the next time each 
app is due to run and launches apps with their specified command- 
line parameters. You can call the Schedule method at any interval, 
but you get the best timing resolution by calling it once every 
second or two. 



timer. At the expiration of each timer interval, TestSched checks for 
apps due to run and performs a unit of work: 

Private Sub Timerl_Timer( ) 
'cycle timer for scheduling 

CheckSchedul e 

Simul ateWorkl oad 
End Sub 

The core of the CheckSchedule routine looks like this: 

If goSched . Schedul erEnabl e Then 

goSched . Schedul e 
End If 

The SimulateWorkload function creates a random work interval 
and updates the progress bar to illustrate TestSched's ability to 
perform independent work while acting as the time base for 
TaskSchedulerDLL. 

To see the scheduler in action, create four copies of ClientApp 
as described in the sample code's readme.txt file. Set up each as 
shown in Figure 1 and start the scheduler. Each copy of ClientApp 
remembers its form position when it runs so you can arrange each 
copy to see all four windows simultaneously. To vary the input 
parameters, add /S and IV to one of the apps and see what happens 
when it's time to reschedule while the prior run hasn't finished yet. 
You can also set the reschedule interval to be shorter than the work 
interval to overlap the runs. If you don't use IS, multiple copies of 
the app run at once and the windows stack on top of one another. 
Play with the settings to see how each works. 

This sample gives you the basics for building your own task- 
scheduling app and shows you how to use parameters to control your 
client apps. You can use TaskSchedulerDLL in your own apps, but 
you must supply your own interface to update scheduled app settings. 
In the simplest case, you can edit the Registry directly to define and 
maintain your schedule settings; follow the Registry structure ex- 
ample the TestSched app illustrates. Now that you know how to 
create a scheduler, you can enhance the app by combining the 
scheduling function with other useful capabilities. VSM 
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Dim m_colApps As Collection 

Publ i c Sub Schedul e( ) 

'check if time to schedule anything 

Dim sStatus As String 

Dim dStatus As Double 

Dim oApp As CProgram 

On Error GoTo Schedul e_Error 

If (Not SchedulerEnable) Or 

(m_col Apps . Count = 0) Then Exit Sub 
For Each oApp In m_colApps 
With oApp 
If .Enabled Then 

If .NextRunTime < Now Then 

.NextRunTime - DateAdd Cs", CDbl 

(Getlnterval InSeconds (.Interval)), Now) 
dStatus - Shell ( . Path & _ 

" " & .Parameters. vbNormal NoFocus ) 
End If 
End If 
End With 
Next 

Exit Sub 
Schedul e_Error : 
Resume Next 
End Sub 
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There's a lot of pressure on us as developers to 
build applications using n-tier technologies. We 
get pressure from managers who want scalability, 
from vendors who want to sell us fancy products, and 
from other developers who wanr to do "cool" work. 
And often our customers want their solution to use 
the latest buzzwords whether they apply to the solu- 
tion or not. 

Many times, using n-tier technology does make a 
lot of sense, but in some situations, it makes more 
sense for you to use a simpler design. In this column, 
I'll tell you when to use an n-tier model and when to 
use a simpler single-tier or two-tier model. A single- 
tier application is one where the entire application 
runs on a single machine and where no serious design 
effort is put into separating the UI formally from the 
business logic from the data. In a two-tier application, 
a database server (such as SQL Server or Oracle) that's 
separate from the client workstation manages the 
application's data. An n-tier application is one where 
the application is designed so it can run across three 
or more computers. Before getting into the details of 
when to use what, you need to understand the differ- 
ence between a logical n-tier application and a physical 
n-tier application. 

You use an n-tier logical model to help manage your 
applicarion's complex aspects. Additionally, an n-tier 
logical model is a prerequisite if you want to implement 
a physical n-tier design. In a logical n-tier design, you 
don't specify how many actual computers or networks 
are involved. An n-tier logical design divides your 
application into several pans — or tiers — that might 
run on one or more computers (see Figure 1). You 
don't need more than one machine, but using an n-tier 
logical design does dictate that you think about which 
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parts of your application fit into each tier and that you 
keep the code for each tier distinct from the other tiers. 

The Good and Bad 
About N-Tier 

The advantage to a logical n-tier architecture is that it 
provides you with an understandable structure for 
your application. You always know where to find 
your UI code, your business logic, and your data 
access code. If you need to change your presenta- 
tion — for instance, from Windows to a browser — 
you only need to rewrite your presentation and UI 
tiers; the business logic and data tiers should be 
relatively unaffected. 

The drawback to an n-tier logical architecture is 
that your application design can be more complex 
rhan the application itself. This is particularly true if 
your application has only a few forms and works with 
only a handful of tables in a database. A single-tier 
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User interface 
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Data services 



Figure 1 Understand the Logical N-Tier Model. 

This logical n-tier model has a presentation tier 
backed by a UI tier. Beneath that is a business logic 
tier, which interacts with the data tier. Because this 
is a logical model, this might all be running on one 
computer, or it might be spread across several 
computers. 
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logical design is about as simple as you can get, and is often more 
appropriate in this situation. 

You've probably created single-tier applications, especially in 
VB, by dragging and dropping some controls onto a form, double- 
clicking on a control or two, and writing code in the form itself to 
access your data, enforce your business rules, and apply your 
validation logic. This type of development is fast and easy to learn. 

An n-tier physical model builds on the work you put into 
creating the logical model and helps make your application scalable. 
You use a physical n-tier design to map your logical design onto 
actual computers. If you start with a four-tier model such as the one 
in Figure 1, you can map your application to a variety of physical 
configurations. All four tiers could run on a single computer, so 
you'd have a logical n-tier model but a physical single-tier model. 
On the other extreme, each of the four tiers could run on a separate 
machine (see the Web application example in Figure 2). 

With a physical n-tier design, you need to pay even more 
attention to which parts of your application are in which tier. 
Communication between your application's tiers almost always 
goes across the network, and your application pays a performance 
penalty each time it makes a call across the network. Because of this, 
you need to make cross-tier communication as efficient as possible 
for performance reasons. 

Figure 2 shows the browser going across the network using 
HTTP to Active Server Pages.NET (ASP.NET). Your ASP.NET 
page uses Simple Object Access Protocol (SOAP), or perhaps .NET 
Remoting, to talk to an application server component, which then 
uses ActiveX Data Objects.NET (ADO.NET) to go across the 
network to the database. To display a simple page in your browser, 
this application must make three cross-network calls, each one 
making the application slower. 

You might wonder why n-tier solutions are so popular if having 
more physical tiers slows down applications. It's because they're 
more scalable (although the fact that they require trendy technology 
doesn't hurt) . If you're using an n-tier architecture as in Figure 2 and 
you find that your .NET application server can't keep up with the 
load, you can add another application server, splitting your load 
between two computers. 

This might all seem complex — and it can be, especially for small, 
focused applications with small numbers of users. I'll make things 
easier by giving you a few guidelines ydu can use to decide whether 
to go for the logical or physical n-tier solution or to opt for a 
potentially simpler single-tier design. 

Understand Design Issues 

You can run into a number of issues, depending on your specific 
organization and requirements. Five of the most common and 
important things you should consider are application size, number 
of concurrent users, timeline pressures, existing staff and skill sets, 
and future requirements. All these aspects are interrelated, and 
factors in your environment and application can affect each of them. 
You should consider all these elements when deciding on your 
application architecture. 

O Application Size 

The key reason you might use a logical n-tier design is to manage 
your application's complexity — that is, improving its structure, 
readability, and maintainability. This is a critical consideration if 
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Figure 2 Deploy the Logical Model Physically. Here's one way 
to deploy a logical n-tier model into an n-tier phys/ca/architecture. 
In this case, you're deploying it across four computers: a client 
with a browser, a Web server running ASP.NET, an application 
server running .NET components, and a database server. 

your application is large and complex. Unfortunately, the terms 
"large" and "complex" are nebulous, and your definition will vary 
from that of the person sitting next to you. I'll give you my general 
rules of thumb. 

If your application has 10 forms (or pages) or less, its UI is not 
large. Likewise, if your application uses data from 1 tables or less, 
it's not large. By this reasoning, if your application has more than 
10 forms or 10 tables, you should be using an n-tier logical design 
to provide structure to your code. An n-tier design might be 
overkill for smaller applications, depending on your application 
and environment. 

@ Number of Concurrent Users 

The architecture you choose for your application has a strong 
impact on both performance and scalability. This is particularly true 
of your physical architecture, because the more physical tiers you 
have, the more network overhead you incur and the slower the 
application will run. 

Performance and scalability are not the same thing, although 
they are interrelated. Performance is the response time of the 
application for an individual user. Scalability describes how perfor- 
mance changes as more concurrent users access your application. In 
a scalable solution, performance degrades slowly, consistently, and 
almost linearly as you add more users to your application. 

Keep in mind that you only care about concurrent users — those 
who are physically sitting at their computers at the same time 
interacting with your application. If your application has 1,000 
users, but only about 300 ever use it at the same time, you don't care 
about the other 700. 

A physical n-tier design can give your application a lot of 
scalability because you can spread the processing of UI, business 
logic, and database logic across many computers. However, for a 
small number of users, an n-tier design is almost always slower than 
a simpler design. 

A lot of applications supporting upwards of 100 users were 
(and probably still are) written in Clipper or FoxPro. Many Visual 
Basic and Microsoft Access applications support 50 or more 
concurrent users. Most of these applications are blindingly fast 
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and serve their users well. Yet these applications aren't n-tier, 
either logically or physically. 

A great many two-tier VB applications talking to SQL Server 
or Oracle support 200 or 300 concurrent users. If you have one of 
these, you've implemented a physical two-tier design, but the 
majority of these applications don't conform to any sort of logical 
n-tier design in a formal sense. Although not as fast for a single user 
as a FoxPro or Access application, these applications can scale up 
to support many more users than their predecessors. 

If your application needs to support more than 300 concurrent 
users, you need to employ more formal n-tier logical and physical 
architectures to provide the level of scalability the application re- 
quires. Because of the increased network overhead, these applications 
will perform worse than your other options for a single user, but you'll 
get more consistent performance as you add more users to the 
application over time. 

/ f your application needs 
to support more than 300 
concurrent users, you 
need to employ more 
formal n-tier logical and 
physical architectures to 
provide the level of 
scalability the application 
requires. 




O Timeline Pressures 

We all must deal with timeline or deadline pressures of one form or 
another. For example, users might require immediate feedback and 
want to see visible progress throughout the development process. 
An n-tier model isn't conducive to meeting this need typically 
because you'll put a lot of effort into tiers other than the UI tier — 
and the UI tier is all your users get to see. A code-behind-the-form 
single-tier model, where you drag and drop controls onto the form, 
double-click on one or two controls, and write your business logic 
right in the form, usually allows you to show your users visible 
results sooner and more often through the process. 

However, a single-tier model might not satisfy true deadline 
pressures. A single-tier model doesn't help you manage your 
application's complexity as it grows, so you might find that it's 
harder to meet your deadlines the further into single-tier develop- 
ment you get. Sure, you have screens to show your users, but each 
screen gets harder to create, and each functional change ripples 



through all your existing functionality. An n-tier logical model can 
help you out here by providing structure and organization to your 
application — but perhaps at the cost of showing your users a 
working UI within the first few days of development. 

O Existing Staff and Skill Sets 

If you've built both single-tier and n-tier applications, you know 
already there's less to know and remember when building single- 
tier applications. The model is simpler and easier, both from a 
logical and physical perspective. 

Before you launch into a large and complex n-tier application 
development process, evaluate your skills and the skills of your team. 
You don't want to be learning all the techniques and concepts of n- 
tier development while building a mission-critical application un- 
der a tight deadline. 

That said, the only way you can learn how to do n-tier develop- 
ment is actually to do it. Sure, you should take classes and read books 
to learn the basics, but most people never truly internalize their 
knowledge until they get a chance to apply it. Start with a pilot, or 
a subset of your application, and learn the lessons there. Then 
expand out to your more critical and larger applications. 

Future Requirements 

Finally, think about the future. You might be building a smaller, less 
complex application today, so you might opt for a single-tier model. 
That's fine, but your own success can be your undoing. 

If you do a good job and your application is well received, it will 
likely draw more users, who want more functionality. Good appli- 
cations have a way of becoming larger and more complex over time, 
often in ways you never anticipated at the start. 

Switching from a single-tier logical model to an n-tier logical 
model isn't easy. In fact, you'll probably have to rewrite your 
application. However, if you build your application using an n-tier 
logical model — even if you're using a physical single-tier model — 
you can accommodate your application's success and growth over 
time much more easily. 

These are some of the key issues you should think through when 
making your design decision. You'll need to consider other options 
as well, such as different types of n-tier models and what object- 
oriented concepts and designs to use. vsm 
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• Programming Tech- 
niques, "Playing the Shell 
Game," by Karl E. Peterson 
[VBPJ September 1995] 

•Ask the VB Pro, "List Your 
Higher Windows," by Karl 
E. Peterson [VBPJ June 
1998] 

•Ask the VB Pro, "Force 
Your Way to the Fore- 
ground," by Karl E. 
Peterson [VBPJ February 
1999] 

•Ask the VB Pro, "Call the 
Right Function," by Karl E. 
Peterson [VBPJ Septem- 
ber 1999] 

• Microsoft Knowledge 
Base Search: http:// 
support.microsoft.com 

•Q178893-"HOWTO: 
Terminate an Applica- 
tion 'Cleanly' in Win32" 

•Q1 82559 -"HOWTO: 
Use VDMDBG Functions 
on Windows NT" 

•Q1 75030- "HOWTO: 
Enumerate Applications 
in Win32" 



New magazine — new column! I'll be bouncing 
between this column and the old familiar, 
though (re-)renamed, Q&A column as we move 
forward. Unlike Q&A, in this column I'll be focusing 
on a single solution, so I hope to be able to go into a 
bit more detail. 

For years, I've seen questions online regarding 
how to kill other applications. I'm not entirely sure 
what brings on all this mayhem, but I'm happy to 
help where possible. In fact, in previous issues of 
Visual Basic Programmer's Journal, I presented por- 
tions of what's now turned into a fairly accurate re- 
creation of the Applications tab on Windows NT's 
Task Manager (see Resources). Missing previously 
was the code to go behind the End Task button, 
which I'll provide in this column. 

Microsoft's Knowledge Base (KB) provides some 
good advice and general implementation ideas about 
shutting down another application (see Resources). 
However, it doesn't cover all the contingencies you 
should account for (you 
knew that was coming). 
It's also not entirely VB- 
friendly, as the majority 
of solutions it provides 
are coded in "another 
language." 

I'll assume you have, 
or know how to obtain, 
the window handle 
(hWnd) of the applica- 
tion you want to kill. If 
not, numerous examples 
are on my Web site at 
www.mvps.org/vb and 
in previous columns I've 
written (see Resources). 
Just as in real life, things 
work out most smoothly 
when everyone's in agree- 
ment. The easiest way to 
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shut down another app is to ask it nicely. You can do 
this by sending the other app a WM_CLOSE message. 

Sending WM_CLOSE to the window handle you 
have isn't sufficient typically because most applica- 
tions comprise numerous windows. The answer: Find 
all the top-level windows belonging to this applica- 
tion and send the message to each. Start by deter- 
mining the application's process ID. This is a unique 
32-bit value that you can obtain using a call to 
GetWindowThreadProcessId. Pass the known hWnd 
as the first parameter, and a variable to accept the 
process ID as the second. GetWindowThread- 
ProcessId returns the thread ID if the call succeeds: 



Dim ThreadID As Long 

Dim ProcessID As Long 

ThreadID = GetWi ndowProcess Id( hWnd , 



ProcessID) 



The Enum Windows API provides a means to 
iterate through the windows list. You pass Enum- 
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Figure 1 Licensed to Kill. Sometimes an application you're trying to shut 
down is simply asking its user what to do next. If you call TerminateProcess 
without the user's permission, you risk the user's ire as the killed app won't 
have had a chance to save its data. Unless you know without question that 
you won't cause any harm, you should confirm extreme actions with the user. 
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Windows the address of a routine and a user-defined value. The 
system then calls the specified routine once for each top-level 
window, passing it an hWnd and the value you choose. For this case, 
you want to pass the ProcessID so you can compare it with the same 
value extracted from the hWnd under consideration. When you 



find matching process IDs, according to the KB, it's time to send a 
WM_CLOSE message. 

Here, you run into two difficulties. First, if the application is hung, 
it won't respond to a SendMessage call. Use either PostMessage or 
SendMessageTimeout to safely avoid hanging yourself while waiting 
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Private Declare Function EnumWindows Lib _ 
"user32" (ByVal IpEnumFunc As Long. IParam _ 
As Any) As Long 

Private Declare Function _ 

GetWindowThreadProcessId Lib "user32" (ByVal 
hWnd As Long. 1 pdwProcessId As Long) As Long 

Private Declare Function GetWi ndowLong Lib _ 
"user32" Alias "GetWi ndowLongA" (ByVal hWnd 
As Long, ByVal nlndex As Long) As Long 

Private Declare Function PostMessage Lib _ 
"user32" Alias " PostMessageA" (ByVal hWnd As 
Long. ByVal wMsg As Long, ByVal wParam As _ 
Long, IParam As Any) As Long 

Private Const GWL_HWNDPARENT = (-8) 

Private Const WM_CL0SE - &H10 

Initiate PostCl oseMessage callbacks like this: 
Call EnumWindowstAddressOf PostCl oseMessage, 
ByVal ProcessID) 



Private Function PostCl oseMessaget ByVal hWnd As . 
Long, ByVal IParam As Long) As Long 
Static PID As Long 

' Check if hWnd belongs to PID: IParam 
Call GetWindowThreadProcessIdfhWnd, PID) 
If PID = IParam Then 

' Belongs to target process, try close 
' message if this doesn't have an owner. VB 
' apps that display a msgbox from 
' QueryUnload will lock a 9x box up hard, 
' if we don't do this test! 
If GetWindowLongfhWnd, GWLJWNDPARENT) „ 
= Then 

Call PostMessageChWnd. WM_CL0SE, _ 
0&, ByVal 0&) 

End If 
End If 

' Return true to continue enumeration. 
PostCl oseMessage = True 



Listing 1 The KB proposes posting a WM_CLOSE message to all top-level windows belonging to a process to terminate it nicely. 
This causes major problems with VB-authored apps if you don't take the additional step of ensuring you're only sending the message 
to ownerless windows. 
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Private Declare Function OpenProcess Lib _ 
"kernel32" (ByVal dwDesi redAccess As Long, 
ByVal blnheritHandl e As Long, _ 
ByVal dwProcessID As Long) As Long 

Private Declare Function Wai tForSi ngl eObject _ 
Lib "kernel32" (ByVal hHandle As Long, 
ByVal dwMi 1 1 i seconds As Long) As Long 

Private Declare Function CloseHandle Lib _ 
"kernel32" (ByVal hObject As Long) As Long 

Private Const SYNCHRONIZE - &H100000 
Private Const INFINITE = -1& 

' Error on call 

Private Const WAIT_FAI LED = -1& 

'Normal completion 

Private Const WAIT_OBJECT_0 = 

'Timeout period elapsed 

Private Const WAIT_TIMEOUT - &H102& 

Public Function Wai tForProcessCl ose( ByVal PID 
As Long, ByVal TimeOut As Long) As Boolean 
' Timeout needs to be passed in milliseconds! 
Dim hProc As Long 
Dim nRet As Long 
Const fdwAccess » SYNCHRONIZE 

1 Try opening process: wait on it to close. 



hProc = OpenProcess ( fdwAccess , False, PID) 

If hProc Then 

nRet = WaitForSingleObjectthProc, TimeOut) 
Select Case nRet 
Case WAIT_TIMEOUT 
' Still open. 

WaitForProcessCl ose = False 
Case WAIT_OBJECT_0 

1 Process has closed. 

WaitForProcessCl ose = True 
Case Else 

' Error on cal 1 . 

WaitForProcessClose = False 

Api ErrorDump Err . LastDl 1 Error . _ 
"Wai tForSi ngl eObject " 
End Select 

Else 

' Nothing we can do, at this point. 
' Process may be gone already? 
ApiErrorDump Err . LastDl 1 Error , _ 

"OpenProcess" 
WaitForProcessClose = True 
End If 
' Clean up. 

Call CloseHandle(hProc) 
End Function 



Listing 2 You can use the WaitForSingleObject API to determine whether a process is still running. Pass the process ID, and how 
long you're willing to wait, to this WaitForProcessClose routine. Execution returns when the process ends or when the timeout 
elapses. Pass INFINITE (-1 &) to wait without timeout. 
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Desktop Developer 




for hung apps. The second dilemma is interesting in that the KB 
writers didn't even consider it. If you send WM_CLOSE to all top- 
level windows of a VB-authored app, and that app typically asks for 
confirmation at shutdown (save yout work? are you sure? and so on), 
things lock up fast. You can avoid this second issue by adding a check 
in the callback routine to ensure the window under consideration is 
ownerless (see Listing 1). 

Again, as in real life, there will be times when asking nicely doesn't 
achieve the results you desire. To determine if WM_CLOSE has 
worked, the Win32 API provides a method to wait for 32-bit 
Windows apps to shut down. Using the known process ID, request 
SYNCHRONIZE access by calling OpenProcess to obtain a handle 
to the process (hProc). OpenProcess might fail with some system 
processes, even with this minimal access request, but in most cases 



you can assume the process no longer exists if OpenProcess fails. 

Pass this hProc to WaitForSingleObject, being sure to specify how 
long you're willing to wait. WaitForSingleObject returns when either 
an object is "signaled" or the timeout period has elapsed. A process 
object becomes signaled when it has terminated. Patience is a virtue, 
but it is limited. A timeout of three to five seconds should be sufficient 
in most cases to know that WM_CLOSE isn't having the intended 
effect (see Listing 2). 

You must now decide whether to simply nuke the process with 
a call to TerminateProcess or ask your user to take responsibility 
for that call. Task Manager provides a fine precedent by telling the 
user that data might be lost and asking whether to wait longer or 
pull the final trigger (see Figure 1). I've created a dialog that 
replicates those shown by NT's Task Manager and exposes a 











Private Declare Function IsWi ndowVi si bl e Lib _ 
"user32" (ByVal hWnd As Long) As Long 

Private Declare Function TerminateProcess Lib 
"kernel32" (ByVal hProcess As Long. 
ByVal uExitCode As Long) As Long 

Private Const SYNCHRONIZE - &H100000 

Private Const PROCESS_TERMINATE As Long - &H1 

Private m_Frm As FNotRespondi ng 

Public Function ProcessClose(ByVal ProcessID As 
Long, Optional ByVal TimeOut As Long - 5000, 
Optional Caption As String, Optional hlcon _ 
As Long) As Boolean 

' First step is to post a WM_CL0SE to all 
' top-level windows owned by process. 
' (See Listing 1) 

Call EnumWindowstAddressOf PostCl oseMessage , 
ByVal ProcessID) 

' Check if process is still there. Allow 
' (default) five seconds for dialogs to be 
' responded to. 

If Wai tForProcessCl ose( ProcessID , TimeOut) _ 
Then 

' Report success (see Listing 2). 
ProcessClose » True 

Else 

' Okay, now things get trickier! 

' Setup and show "Not responding" form. 

Set m_Frm - New FNotRespondi ng 

m_Frm.TaskName = Caption 

m_Frm. hlcon = hlcon 

m_Frm. Show 

' Loop until "Not responding" form is 

' hidden, which happens when either button 

' is pressed. 

Do While I sWi ndowVi si bl e(m_Frm. hWnd) 
' Yield execution. 
DoEvents 



' Need to monitor process to see if it 
' closes on its own (in response to 
' user input, perhaps) while dialog 
' is up. 

If Wai tForProcessCl ose( ProcessID. 10) _ 
= True Then 

' Process has had normal shutdown! 
m_Frm. Cancel 1 ed = True 
ProcessCl ose - True 
End If 
Loop 

' If user said "End Now!", kill that sucker 
If m_Frm. Cancel 1 ed - False Then 

ProcessClose = ProcessKi 1 1 ( ProcessID) 
End If 

' Clean up dialog. 
Unload m_Frm 
Set m_Frm = Nothing 
End If 
End Function 

Public Function ProcessKillt 

ByVal ProcessID As Long) As Boolean 

Dim hProc As Long 

Const fdwAccess As Long - _ 

SYNCHRONIZE Or PR0CESS_TERMI NATE 

' Need to open process with terminate rights, 
' or just give up immediately. 
hProc - OpenProcess(fdwAccess , 0&. ProcessID) 
If hProc Then 
' Kill it. 

If TerminateProcessthProc. 0&) Then 

ProcessKi 1 1 = True 
Else 

ApiErrorDump Err . LastDl 1 Error , _ 
"TerminateProcess" 
End If 
' Clean up. 

Call CloseHandle(hProc) 
End If 
End Function 



Listing 3 This code handles most termination tasks discussed in this column. It relies on a nonmodal form that asks the user whether 
to proceed (shown in Figure 1). FNotResponding has several custom properties that tell it how to set itself up in its Form_Load 
routine. This form does nothing but collect user feedback and hide itself when users press either the End Now or Cancel button. 
Pressing either button sets another custom property that alerts the caller of the form's disposition. If the process does shut itself 
down while the wait dialog is visible, the dialog is hidden and all's well. 



Visual Studio Magazine • September 2001 • www.vbpj.com • www.vcdj.com 



number of custom properties that help it set 
itself up when loading. If WM_CLOSE 
doesn't work, the ProcessClose routine 
shows the FNotRespondingform nonmod- 
ally, then enters a wait loop (see Listing 3). 

While waiting, ProcessClose calls 
WaitForProcessClose repeatedly with a 
short timeout (10 milliseconds) and checks 
whether FNotResponding is still visible, 
exiting the loop should either of these oc- 
cur. Call DoEvents on each iteration to 
yield the processor to the target application 
and allow your user to click on the buttons 
on FNotResponding. 

Tie Up Loose Ends 

You also need to be aware of the oddities 
you'll encounter when shutting down 16- 
bit apps. Under Windows 9x, 16-bit apps 
are "equal citizens" and the code presented 
here works fine. In NT, Win 1 6 apps run as 
separate tasks (threads) under a 32-bit Vir- 
tual DOS Machine (VDM) process. Mul- 
tiple Win 16 apps can run within a single 
Windows on Win32 (WOW) VDM. 

The cleanest way to shut down a Win 16 
app is to kill the entire VDM process, but 
this risks closing more than just the target 
task. Under NT, you can use functions 
from VDMDBG.dll to determine the ex- 
tent of potential carnage should you decide 
to terminate the VDM (see Resources). 
This DLL also supplies a function to kill a 
single task within a WOW VDM, buc there 
are no guarantees the resulting VDM will 
be stable. 

Given these considerations, if your app 
is also a task launcher, you should always 
launch Win 16 apps within separate pro- 
cesses. Calling CreateProcess rather than 
Shell and specifying the CREATE_ 
SEPARATE_WOW_VDM flag achieves 
this separation. If you enjoy this low-level 
control and want to pluck individual tasks 
from within a VDM, take a look at the 
VDMDBG functions (or stay tuned to this 
column). VSM 



Karl E. Peterson is a GIS analyst with a 
regional transportation-planning agency and 
serves as a member of the VSM Technical 
Review and Editorial Advisory boards. Online, 
he's a Microsoft MVP and a section leader on 
several DevX forums. Find more of Karl's VB 
samples atwww.mvps.org/vb. E-mail Karl at 
karl@mvps.org to let him know what you 
think of this new column. 
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Extract Color Values 
Painlessly 



by Karl E. Peterson 



Technology Toolbox 

□ VB.NET 

□ C# 

□ SQL Server 

□ ASP.NET 

□ XML 
^VB6 
®f Other 

VB3, VB4, VB5 



Resources 

Ask the VB Pro, "Toggle 
Showlnl askbar at Run 
Time" item, by Karl E, 
Peterson [Visual Basic 
Programmer's Journal 
January 2001] 



Ql Color Breakout 

I use the GetPixel API to retrieve color values from 
within images. It returns red, green, and blue color 
values, packaged as a single Long value. I've seen tips 
that show how to convert a Long to a hexadecimal 
string, then use the Mid function to extract two- 
character portions of the string, but that's far too slow 
for my needs. Is there an API to break out these 
individual color values rapidly? 



A: 



I've seen those tips too, and they certainly seem awk- 
ward at best. If you're unfamiliar with how color values 
are stored within a Long variable, or if you simply have 
trouble remembering (as I do), here's an easy trick to 
jog the memory. Drop into the Immediate window 
and type the first line: 

?Hex(vbRed), Hex(vbGreen) , Hex(vbBlue) 
FF FF00 FF0000 

This tells you the four bytes composing a Long are 
arranged as xxBBGGRR, where "xx" is a filler byte, 
"BB" is the blue value, "GG" is the green value, and 
"RR" is the red value. You've heard that a little 
knowledge can be dangerous, hence the tips you've 
seen built on this understanding. Extracting a single 
color value from a Long using string manipulation 
would be a killer if you had to do it more than a 
handful of times. For example, you need these gyra- 
tions merely to extract red (the easiest of the three!): 

Red « CByte("&H" & _ 

Right$(Hex$(value) , 2)) 



If you have color values stored in Long variables 
already, you can use a bitmask to extract only the 
byte(s) you're interested in. I think you'll agree that 
simply masking off the last byte to determine the red 
component is much easier: 

Red = (Value And &HFF) 

You can use similar bit-masking operations to 
extract green and blue values, although they require 
some bit-shifting as well (see Listing 1). But even 
these efficient methods can prove slower than desired 
if you're in a highly iterative situation, such as when 
working with all the pixels in a bitmap. In such a case, 
especially if you needed all three color components, 
you'd want to break apart the byte-encoded value as 
quickly as possible. You can do this with a single 
CopyMemory call, which transfers the Long to a 
user-defined type (UDT) defined to match the known 
byte ordering. 

The Windows API provides the PALETTE- 
ENTRY structure, which matches exactly the byte 
ordering within a 32-bit memory value. You're not 
actually dealing with palettes, so it makes sense to 
define your own similar structure to avoid confusion 
(see Listing 2). But this is still one step shy of the 
ultimate optimization. If you need the individual 
color bytes and not the fully combined color value, 
why not just ask for that in the first place? You avoid 
the extraction issue altogether by redefining the 
GetPixel API call so it returns a custom RGB32 
structure rather than a Long: 

Private Declare Function GetPixelRGB _ 

Lib "gdi32" Alias "GetPixel" (ByVal hDC As Long, _ 
ByVal x As Long, ByVal y As Long) As RGB32 
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If your needs are highly iterative and you need the RGB values 
separated more often than combined, this is the only way to go (see 
Figure 1). 

Qj Add a Border to Borderless Forms 

I'm using your CFormBorder class with no problems (see Re- 
sources). However, I'm trying to create a 3-D form (much like the 
one you get with the WS_DLGFRAME style) without a titlebar. 
Can this be done? I need a 3-D border that doesn't allow or accept 
resizing, yet doesn't have a titlebar either. 

hi 

You have two choices. You can either use the DrawEdge API on a 
normal borderless form, or you can subclass and eat the 
WM_SIZING messages sent to your form. The first is by far the 
easiest and cleanest, unless you have other needs that also dictate 
subclassing the form. 

The DrawEdge API is also an incredibly useful function, espe- 
cially when creating custom UsetControls that completely draw 
their own interface. Call DrawEdge from the Form_Paint event if 
you're leaving Auto Redraw set to the default, False. Pass yout form's 
hDC property as the device context (DC) to draw on, a RECT 
structure indicating where to draw, the edge style you'd prefer, and 
a flag (BF_RECT) indicating DrawEdge should draw a rectangle. 

I usually find it easiest to set my form's ScaleMode to vbPixels. 
In this case, that also facilitates stuffing the passed RECT structure, 

f VB3, VB4, VB5, VB6 • Extract RGB Values From Longs^\ 



■ ************************************************** 
' Direct translation of the native C Macros 
' provided by Brad Martinez. 
' www.mvps.org/btmtz 

1 ************************************************** 
Public Function GetRVal ue( ByVal rgb As Long) 
As Byte 

' //define GetRVal ue( rgb) ((BYTE) (rgb)) 
GetRValue = (rgb And &HFF) 
End Function 

Public Function GetGVal ue(ByVal rgb As Long) 
As Byte 

' //define GetGVal ue< rgb) ((BYTE) (((WORD) 

(rgb)) >> 8)) 
GetGValue = (rgb And &HFF00&) \ &H100 
End Function 

Public Function GetBVal ue( ByVal rgb As Long) 
As Byte 

1 //define GetBVal ue( rgb) ((BYTE) ((rgb) >> 16)) 
GetBValue = (rgb And &HFF0000) \ &H10000 
End Function 



Listing 1 Red, green, and blue (RGB) color components are 
byte-encoded within a 32-bit value (Long), and you can extract 
them using simple bit-masking and bit-shifting. These functions 
provide the easiest extraction possible and prove the ideal 
solution in all but highly iterative processes. Even VB3 users 
can employ this technique simply by returning the result as an 
Integer rather than a Byte. 



as you can simply assign the form's ScaleWidth and ScaleHeight as 
the Left and Bottom rectangle dimensions (see Listing 3). Alterna- 
tively, use your form's Scale method to convert coordinates from 
another ScaleMode. 

V£j Longer Timer Intervals 

I've been working on a VB app that downloads images from five 
network cameras, and I need to set the interval for each cam 
individually. I want the cams to download the images to the hard 
drive at different times and varying intervals ranging from one to 1 



GetPixelRGB Demo 
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Figure 1 Extracting Color Values Needn't Be Scary. In this 
demo, it takes far more work to display the color under the cursor 
than it does to obtain it. Redefining the GetPixel API so it returns 
a custom RGB32 structure eliminates the step of breaking red, 
green, and blue values out of a 32-bit color value. 



( VB5, VB6 • Split RGB Values With One API Call "\ 



Private Declare Sub CopyMemory Lib "kernel32" 
Alias "RtlMoveMemory" (Destination As Any, 
Source As Any, ByVal Length As Long) 

Publ ic Type RGB32 

Red As Byte 

Green As Byte 

Blue As Byte 

Pad As Byte 
End Type 

Public Function Spl itColors(ByVal Value _ 
As Long) As RGB32 

Call CopyMemorytSplitColors. Value. 4) 
End Function 



Listing 2 When you need to know the individual color component 
values within a 32-bit value rapidly, you can rearrange your view 
of the memory content by copying it into a UDT coded to match 
its layout. For this CopyMemory call, the function return serves 
as the target and the passed 32-bit color value is the source. 
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IhHBHHBHnBHBBhe 

Q A 



Re 



\emember, timers 
aren't guaranteed to fire 
when you ask, only no 
sooner than you ask. 

minutes. I know I can't use the VB timer, which is limited to 63 
seconds. A great idea from you would bail me out of my biggest 
problem so far with this application. 



This is an extremely common misconception regarding VB's intrin- 
sic Timer control. VB does retain many of its 1 6-bit roots and, yes, 
the Interval property is indeed limited to 65,535 milliseconds — 
about 65 72 seconds — but that doesn't mean you can't use it for 
firing at a longer interval. There's absolutely nothing wrong with 
receiving more frequent notifications, as long as you're aware of 



when the needed duration has elapsed, right? 

Whenever you need notifications of periods longer than sup- 
ported direcdy, go ahead and use a standard VB Timer control. Set 
its Interval property to the greatest common denominator of your 
various needs. In this case, your needs range from one to 1 minutes, 
so you could use a one-minute interval (60,000). If you need 
notifications on the half-minute marks, say at 3'/2 and 572, you 
could use a half-minute duration (30,000). 

Use a static counter within the Timer event to keep track of how 
many notifications have passed. When you reach the magic mul- 
tiple, fire off the code that needs to run. For example, say you need 
to perform a given task every five minutes. I like to set the timer's 
Interval property to a value no more than half the resolution I'm 
seeking. In a case like this, I'd probably want an event every 30 
seconds or so. This code within the Timer event keeps track of how 
many times the event has fired, so it can determine when to execute 
the periodic code: 

Private Sub Timerl_Timer( ) 
Static Counter As Long 
Counter = Counter + 1 
If Counter >= 10 Then 



VB5, VB6 • Easy API Draws 3-D Borders 

i 







Option Explicit 

Private Declare Function DrawEdge Lib _ 
"user3Z" (ByVal hDC As Long, qrc As RECT, 
ByVal edge As Long, ByVal grfFlags As Long) 
As Long 

Private Type RECT 

Left As Long 

Top As Long 

Right As Long 

Bottom As Long 
End Type 

7* 3-D border styles */ 
Private Const BDR_RAISEDOUTER = &H1 
Private Const BDR_SUNKEN0UTER - &HZ 
Private Const BDR_RAI SED I NNER = &H4 
Private Const BDR_SUNKENINNER - &H8 

Private Const EDGE_RAI SED - (BDR_RAISED0UTER _ 

Or BDR_RAISEDINNER) 
Private Const EDGE_SUNKEN = ( BDR_SUNKEN0UTER _ 

Or BDR_SUNKENINNER) 
Private Const EDGE_ETCHED 

Or BDR_RAISEDINNER) 
Private Const EDGE_BUMP 

Or BDR_SUNKENINNER) 







( BDR_SUNKEN0UTER 
(BDR_RAISED0UTER _ 



'/* Border flags */ 

Private Const BF_LEFT = &H1 

Private Const BF_T0P = &H2 

Private Const BF_RIGHT = &H4 

Private Const BFJ0TT0M = &H8 

Private Const BF_RECT - (BF_LEFT Or BF_T0P Or 



BF_R1GHT Or BF_B0TT0M) 

Private Sub Combol_Cl i ck( ) 

Me . Refresh 
End Sub 

Private Sub Form_KeyPress( KeyAsci i As Integer) 
If KeyAscii - vbKeyEscape Then Unload Me 
End Sub 



EDGE_RAISED 
EDGE_SUNKEN 
EDGE_ETCHED 
EDGE_BUMP 



Private Sub Form_Load() 
Me . KeyPrevi ew » True 
Me.ScaleMode « vbPixels 
With Combol 

.Addltem " EDGE_RA I SED" 
. ItemDataf .Newlndex) = 
.Addltem " EDGE_SUNKEN" 
. ItemData (. Newlndex) = 
.Addltem "EDGE_ETCHED" 
. ItemData( .Newlndex) = 
.Addltem "EDGE_BUMP" 
. ItemDataC .Newlndex) = 
. Listlndex = 
End With 
End Sub 



Private Sub Form_Paint( ) 
Dim r As RECT 
Dim edge As Long 

r. Bottom = Me . Sea 1 eHei ght 

r. Right = Me . Seal eWi dth 

edge - Combol . ItemData (Combol . Li st Index) 

Call DrawEdgetMe.hDC, r. edge, BF_RECT) 

End Sub 



Listing 3 DrawEdge is an API every VB developer who designs user interfaces or components should be familiar with. It offers some 
interesting and standardized options with little hassle. The code here lends a 3-D border to a form whose BorderStyle property has 
been set to 0-None. 
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Option Explicit 


Started - timeGetTime - Elapsed 




Else 


' Number of milliseconds since Windows started 


' Update elapsed time. 


Private Declare Function timeGetTime Lib _ 


Elapsed = timeGetTime - Started 


"winmm.dll" () As Long 


End If 


' Number of milliseconds between tasks. 


If Elapsed >= (m_WorkPeriod - CloseEnough) _ 


Private m_WorkPeriod As Long 


Then 




Call RunPeriodicCode 


Private Sub Form_Load() 


' Reset counters. 


' Setup timer 


Started = timeGetTime 


Timerl . Interval = 100 


El apsed = 


Timerl . Enabl ed = True 


End If 


m_WorkPeriod = 1000 


End Sub 


End Sub 






Private Sub RunPeriodicCodet ) 


Private Sub Timerl_Timer( ) 


Static LastCall As Long 


Static Elapsed As Long 


Static ThisCall As Long 


Static Started As Long 




Const CloseEnough As Long = 30 


ThisCall = timeGetTime 




If LastCall > Then 


If Started = Then 


Debug. Print ThisCall - LastCall 


' Set elapsed to current Interval, 


End If 


' assuming one has passed. 


LastCall - ThisCall 


Elapsed ■= Timerl . Interval 


End Sub 



Listing 4 Don't count only X milliseconds having elapsed just because that's the value you set as your timer's Interval property. 
Nearly always, you'll find that X+Y have actually gone by. Paste this code into a form with a Timer control on it and be prepared to 
have some illusions shattered. On 9x systems, the variance will be greater than on NT systems, but in no cases will you see exactly 
what you'd expect (unless you've fought this battle before). Windows gives standard timers low priority, and even at that they tick 
only at a multiple of the system clock chip's frequency — typically once every -55 ms. 



' With a 30-second interval, 
' 10 would represent five min. 
Call RunFiveMinuteCode 
Counter = 
End If 
End Sub 

Another way to code the counter would be to add the 
Timer. Interval on each notification. This would result in slightly 
more readable code: 

Private Sub Timerl_Timer( ) 
Static Counter As Long 
Counter = Counter + Timerl . Interval 
If Counter / 1000 >= 5 Then 
' Divide by 1000 to convert 
' milliseconds to seconds. 
Call RunFiveMinuteCode 
Counter - 
End If 
End Sub 

For even greater accuracy, consider calling either the timeGetTime 
or GetTickCount API to keep track of how long it's been since you 
last fired off the periodic code. Both of these APIs tell you the 
number of milliseconds since Windows started. (If you think you 
might be running on a machine that hasn't been rebooted in more 
than 50 days <snicker>, you'll have to code for roll-over!) 

Remember, timers aren't guaranteed to fire when you ask, only 



no sooner than you ask. If the system is busy, you might miss 
occasional timer ticks. So it makes sense to check an elapsed time 
source when you can't afford to be too latent. Also, when firing 
optimally, system timers operate at a multiple of the system clock — 
roughly one beat every 55 milliseconds on 9x systems — so you need 
to determine what's "close enough" to consider a given interval has 
elapsed (see Listing 4). vsm 



Karl E. Peterson is a GIS analyst with a regional transportation- 
planning agency and serves as a member of the VSM Technical 
Review and Editorial Advisory boards. Online, he's a Microsoft MVP 
and a section leader on several VSM forums. Find more of Karl's VB 
samples at www.mvps.org/vb. 
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Generate and Read 
XML Documents 

.NET's XmlWriter and XmlReader make it easier to write and read XML documents. 



Technology Toolbox 

a' VB.NET 

□ C# 

□ SQL Server 

□ ASP.NET 

□ XML 

□ VB6 
a' Other 

.NET Framework beta 2 



Resources 

• "Use the Simple API for 
XML" by Yasser Shohoud 
[XML Magazine Winter 
2000]: www.devx.com/ 
upload/free/features/xml/ 
2000/05win00/yy0005/ 
yy0005.asp 

•"XSD for Visual Basic 
Developers": www. 
devxpert.com/tutors/xsd/ 
xsdvb.asp 

• "Understanding XML 
Namespaces": www. 
devxpert.com/tutors/xmlns/ 
xmlns.asp 

• .NET Framework class 
library documentation: 
http://msdn.microsoft.com/ 
library/default.asp?URL=/ 
library/dotnet/cpref/ 
frlrfsystemxml.htm 



I wm enerating XML from code has always been 
inconvenienttosaytheleast. Fortunately, .NET 
introduces a new, cleaner model that makes it effi- 
cient to produce and read XML documents. In this 
column, I'll show you how to use .NET's new XML 
generation and parsing models. 

Today, you have three options to generate XML: 
You can use string concatenation, the Document 
Object Model (DOM), or a class you create that acts 
as a Simple API for XML (SAX) ContentHandler and 
writes out the XML (see Resources for more informa- 
tion on SAX). Each of these options has drawbacks. 
Although string concatenation is the easiest to use, it 
results in messy, hard-to-read, fragile code. It's also 
easy to generate malformed XML because nothing 
checks the string you create. 

Using a DOM document makes your code more 
structured and ensures the resulting XML is well 
formed. But it's a lot of work, because you have to 
create each node, set its value or text content, then 
append it to its parent. Both string concatenation and 
the DOM cache the entire document in memory. 
This doesn't work for large documents, especially if 
your application generates many such documents 
concurrently. Using SAX to generate XML solves the 
document size problem, but you still have to create 
the actual class that writes to the disk file or the 
stream. That's too much work you have to repeat. 

XmlWriter is an abstract class in the .NET 
System.Xml namespace that's designed to solve the 
problem of generating XML programmatically. 
XmlWriter offers a forward-only, noncached model 
for writing XML. You tell it to write an element start 
tag and it writes it out, then you tell it to write the 
element's text content and it writes that, and finally 



by Yasser Shohoud 

you tell it to write the element close tag and it writes 
that. XmlWriter lends itself to most scenarios where 
you generate XML programmatically. 

In some scenarios, it's better to use another method 
of writing out the XML (see Table 1). For example, if 
you're creating an XML document and you need to 
have random access to its contents while you're creat- 
ing it, using the DOM is better because it allows you 
to update the document while accessing its nodes in 
any order as needed. Also, ifyou're generating an XML 
document based on data retrieved from a database, you 




.NET XmlReader 



Read methods 



Your application 



Figure 1 .NET's XmlReader Reads the Document 
Sequentially. This sequential reading is similar to 
how the SAX parser works. The XmlReader doesn't 
use callbacks, but it lets your application pull the data 
when it needs to. The XmlReader parsing model is 
similar to a read-only, forward-only ADO recordset. 
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Scenario 


What to use 


Updatinq contents of an existinq document or appendinq content to 
an existing document 


DOM 


Creating a small XML document from scratch 


DOMorXmlWriter 


Generating XML from a database 


DataSet.Xml or database's XML support 


Several objects contributing content to an XML document 


XmlWriter (you can use DOM, but it's 
more cumbersome than passing 
around an XmlWriter) 


Creating a large XML document from scratch 


XmlWriter 


Writing XML to a document and simultaneously accessing its 
contents randomly 


DOM 



Table 1 Review These XML Creation Scenarios. Here are the best ways to create XML in different situations. Scenarios that 
involve updating an existing document are easier to implement using the DOM. Creating XML from a database is done best using the 
database itself, such as SQL Server 2000, or the data access layer, Such as System. Data. DataSet. 



should consider using the DataSet's Xml property to get the XML 
representation of that data. This is better than using XmlWriter 
because you don't have to write code to convert the data to XML and 
you can control the returned XML's structure by using an XML 
Schema Definition (XSD) schema (see Resources for more informa- 
tion on XSD). Note that if you have an existing XML document you 
want to update, you can't use XmlWriter because XmlWriter replaces 
the entire contents of the existing document with whatever you're 
trying to write out. 

Get Started With XmlWriter 

To use XmlWriter, you need to use a concrete class that inherits 
from it. XmlTextWriter inherits from XmlWriter and lets you write 
XML out to a text file, a TextWriter, or a Stream. Try writing out 
an XML document that contains order information. You first 
instantiate an XmlTextWriter and pass it a TextWriter, a Stream, or 
a file path (see Listing 1). You also pass it a System.Text.Encoding 
object, which specifies the type of encoding to use — for example, 
ASCII, Unicode, or Universal Transformation Format (UTF)-8. 
This is especially important if the XML you're generating includes 
international characters. You can also set the XmlTextWriter's 
Formatting property to Formatting. Indented, telling it the output 
should be formatted nicely with new lines and indented elements. 
You do this normally if people will read your XML document; 
otherwise, there's no need for the extra white space. The actual 
writing starts when you call XmlTextWriter. WriteS tartDocument () , 
which writes out the XML declaration. 

There are two ways to write elements within a document. First, 
if the element is empty or contains only text content (no child 
elements), you can write the element using WriteElementString. 
This method lets you write out an element and its text content with 
a single method call. Second, you write an element that contains 
child elements by first writing the element start tag using 
WriteStartElement. This writes the element start tag (for example, 
<order>) so the next thing you write becomes a child of the order 
element. You can then write a child element using Write- 
ElementString. Finally, calling WriteEndElement writes the ele- 
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Listing 1 This example writes an XML document containing orders 
to a text file. You need to call the Close!) method after you finish 
writing to make sure the file is closed. 



Dim w As XmlTextWriter 
'Use Unicode encoding 

Dim enc As New System. [Text] . Uni codeEncodi ng( ) 
w - New Xml TextWri terftxtPath .Text , enc) 
'use indentation 

w. Formatting = Formatti ng . Indented 
'indent by 4 spaces 
w. Indentation = 4 
'write the XML declaration 
w.WriteStartDocument( ) 
'write the orders element 
w.WriteStartElementt" orders") 
'write an order 
w.WriteStartElementt "order" ) 
'add the id attribute 
w.WriteAttributeStringt "id" . "10248" ) 
'using XmlConvert to write typed data 
Dim dtorderDate As Date 
dtorderDate - CTypet "7/4/2000" , Date) 
'the attribute value is a date 
'this will be written as 2000-07-04 
w.WriteAttributeStringt "orderDate" , 
Xml Convert. ToString( dtorderDate)) 
'write the company element 
w. Wri teEl ementStri ng( "company" . 
"Vins et alcools Chevalier") 



' . . . Other code omitted . . . 



'close order element 
w . Wri teEndEl ement ( ) 
'close orders element 
w.WriteEndEl ementt ) 
'close writer 
w. CI ose( ) 
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Expert XML j 



ment closing tag (for example, </order>). You can nest calls to 
WriteStartElement to give you the desired document hierarchy. For 
example, you can use this code to write an XML document: 

w. Wri test art El ement ( "orders" ) 
w.Wri teSt art El ement ( "order" ) 
w.WriteStartElementt "company") 
W.WriteEndElemenU ) 
W.WriteEndElemenU ) 
w.WriteEndElemenU ) 

The preceding code writes this document: 

<orders> 

<order> 

<company></company> 

</order> 
</orders> 

You can write element attributes using WriteAttributeStringO, 
which lets you write the attribute name and value with one method 
call (see Listing 1). 

In most applications, you'll want to write some nonstring data to 
the XML document. For example, you might wonder how to format 
the date when writing a date value. You should use the standard XSD 
representation of the data type you're writing to facilitate 
interoperability and portability. Use the System.Xml.XmlConvert 
class's ToString method to convert variables to their XSD-compliant 
string representation. For example, use this code to write out an 
attribute with a date value, where dtorderDate is a Date variable: 

w.Wri teAttri buteStri ng( "order Date" , 
Xml Convert .ToStri ng( dtorderDate ) ) 

VB.NET • XmlReader Reads an XML Document and 
RCP0rtS °" " S C0 " tentS 



Dim reader As Xml TextReader 

reader = New Xml TextReadert txtPath . Text ) 

Whi 1 e reader . Readt ) 

Select Case reader . NodeType 
Case Xml NodeType . El ement 

Debug .Wri teLi net " El ement -- " & _ 

reader. Name) 
If reader. AttributeCount > Then 
While reader. MoveToNextAttri butet ) 
Debug. WriteLine _ 

(" Attribute -- " & _ 
reader. Name & 
":" 8. reader. Val ue) 
End While 
End If 
Case Xml NodeType .Text 
Debug. WriteLinet "Text 
reader . Val ue) 
Case Xml NodeType .Comment 

Debug. WriteLine( "Comment -- " & 
reader . Val ue ) 
End Select 
End While 
reader. Close( ) 



Listing 2 You can use XmlTextReader.ReadO to read a node. Then, 
based on the type of node, report the node type and possibly its 
value. Note that elements don't have values; their text content is 
another node you read separately. 



This makes it easy for you to write typed values without having to 
worry about their string representation. Here's the resulting XML: 

<?xml versi on="l . 0" encodi ng="utf - 16" ?> 
<orders> 

<order i d=" 1 0248" orderDate= 
"2000-07-04T00:0O:00.0000"> 
<company>Vins et alcools 

Cheval i er</company> 
<product name="Queso Cabrales"> 
<quantity>12</quanti ty> 
<di s count >0</di scount> 
<employee id="5">Steven 
Buchanan</empl oyee> 
</product> 
</order> 
</orders> 

Use XML Namespaces 

In many cases, you might want to use XML namespaces in the 
document you're generating (see Resources for more information on 
XML namespaces). XmlWriter makes this easy by providing over- 
loaded methods for writing elements and attributes with namespaces. 
You write out the order information using namespaces by using an 
overloaded version of WriteElementString or WriteStartElement 
that takes in the namespace prefix and the actual namespace to use: 

Dim ns As String = "http://schemas.devxpert.com/orders/" 
w.Wri teSt art Document ( ) 

'passing an empty prefix makes it the default namespace 

w. Wri teStartEl emenU " " , "orders", ns) 

'the order element will belong to the default namespace 

w.Wri teStartEl ement ( "order" ) 

'the id attribute is in the same namespace 

w. WriteAttributeStringf "id" ,ns , "10248") 

Declare a default namespace by simply passing an empty string for 
the prefix. Similarly, you can specify a namespace for an attribute by 
using WriteAttributeString with the namespace and optionally with 
the namespace prefix. The resulting document contains the neces- 
sary namespace prefix declarations: 

<?xml versi on="l . 0" encodi ng="utf -16"?> 
<orders xmlns= 

"http: //schemas . devxpert . com/orders / "> 
<order nl : i d=" 10248" 
orderDate= 

"2000-07-04TOO:00:00.0000" 
xml ns : nl= 

"http: // schemas .devxpert . com/orders/ "> 
<!-- other xml omitted --> 
</order> 
</orders> 

Writing XML is only half the problem; you'll eventually want to 
read the XML document. Right now you probably use the DOM or 
SAX to parse XML documents. DOM is easy to use but isn't practical 
for large documents for the reasons I mentioned before. SAX solves the 
problem of reading XML documents, but you have to write your code 
in an awkward way to conform to the SAX parsing model. 
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.NET introduces the concept of an XmlReader. This is similar to 
SAX in that it's forward-only and read-only, and it doesn't load the 
entire document into memory. This consumes fewer resources than 
the DOM. Unlike SAX, the XmlReader puts you in control of the 
parsing. Instead of implementing callbacks and waiting for the parser 
to pass you the data, you call XmlReader methods to extract the data 
when you're ready for it (see Figure 1). Think of XmlReader as an 
ADO recordset with a forward-only, read-only cursor. XmlTextReader 
is a nonvalidating concrete implementation of the abstract XmlReader 
that lets you open an XML document from a Stream, a TextReader, 
or a file. If you need to validate using a DTD or a schema, you use 
XmlValidatingReader. 

You can use XmlTextReader to report on an XML document's 
contents (see Listing 2). You first create an XmlTextReader, passing 
it the path of the file to read. You then use XmlTextReader.Read() 
to read one node at a time from the file. The Read() method returns 
true while nodes are being read, and it returns false when you reach 
the end of the document. Once you read a node from the document, 
you can use NodeType to find out the type of node — for example, 
element, comment, or text node. You can also use properties such as 
LocalName and Value to get information out of that node. You can 
read element attributes by using GetAttribute to get the attribute by 
name, and you can use MoveToNextAttribute to loop through all 
element attributes (see Listing 2). XmlReader is ideal for many 
practical scenarios where you're dealing with XML documents of 
unlimited sizes — for example, if you're trying to compare two XML 
documents and find the differences (you can download code for this 
from the VSM Web site; see the Go Online box for details). 



With XmlWriter and XmlReader, .NET adds more tools to 
your XML toolbox, enabling you to choose the best tool for the 
job. To learn more about these tools, download and examine this 
article's code, then try XmlWriter and XmlReader in your own 
applications. ' 



Yasser Shohoud has been writing software for a living for more than 
12 years. An independent consultant and trainer, he specializes in 
XML and Web services and speaks at conferences including VSLive/ 
VBITS, VS Connections, and XML Technical Summit. His articles 
appear regularly in VSM, XML Magazine, and MSL N Magazine. You 
can reachYasseratshohoudy@devxpert.comorwv\w.devxpert.com. 
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Automate Text 
Graphics Creation 



With this LabelMaker WebForm, you'll never need to drag out your 
paint program to create simple GIF image labels again. 



by A. Russell Jones 



Technology Toolbox 

& VB.NET 

□ C# 

□ SQL Server 
& ASP.NET 

□ XML 

□ VB6 
a' Other 

.NET Framework 

Resources 



• .NET Framework Developer's 
Guide: http://msdn. microsoft. 
com/library/default.asp?url=/ 
library/en-us/cpguidnf/html/ 
cpcongettingstartedwith 
netframework.asp?frame=true 

• Visual Basic Start Page: 
http://msdn. microsoft. 
com/library/default.asp?URL=/ 
library/devprods/vs6/vbasic/ 
vbcon98/vbstartpage.htm 

• .MET System. Drawing 
Namespace: http://msdn. 
microsoft.com/library/ 
default.asp?URL=/library/dotnet/ 
cpref/f rlrfSystemDrawing.htm 

•DevX.NET Guide: 
www.devx.com/dotnet/ 



When companies move to the Web, they 
often pour hundreds of hours and thou- 
sands of dollars into one task: creating images that 
display text labels. Labels whose image content 
consists only of text improve the look of companies' 
browser-based interfaces. For example, take a look 
at Fawcette Technical Publications' Web site (www. 
fawcette.com); much of the fancy text on that page 
is actually images. At large sites, professional graphic 
artists perform image-creation tasks, using sophisti- 
cated drawing programs to create the images, but 
many sites are too small to have a dedicated graphics 
staff. Now, rather than (painfully) using Windows 
Paint to build image labels, you can tell the server to 
make a label for you (see Figure 1). 

You can create a LabelMaker WebForm easily in 
Active Server Pages.NET (ASP.NET) that lets users 
specify the label requirements. Form users can specify 
the label text, background color, text color, font and 



A Custom Label 



Figure 1 The LabelMaker Application Generates 
This Typical Label. The raised border isn't part of 
the image itself — the browser's style attribute 
generates it. Internet Explorer (IE) 5.5 doesn't 
always draw the border correctly. However, IE6 
(beta) and Netscape 6 have no such problems. 



font size, and the border color and width. The pro- 
gram you'll create uses the form input values to create 
a graphic image that meets the specifications and 
makes it available in such a way that users can save the 
image as a file for use in some other application. 

The WebForm creates the label by setting the 
imageURL property on an image control. When the 
browser parses the page, the image control performs 
a GET request for the image data, and the page 
returns a GIF image that meets the specifications. 
The user can right-click on the image to save it to a 
local file. 

Create a new ASP.NET project in .NET (this 
column's sample code uses Visual Basic.NET, but 
any .NET language works just as well). Name the 
project LabelMaker and rename the default WebForm 
to defineLabel.aspx. The WebForm consists of sev- 
eral Label controls; a TextBox control for the label 
text; several DropDownList controls that let the user 
select the font name and size; the background, text, 
and border colors and the border style; a CheckBoxList 
control containing checkboxes for the font style (such 
as bold and italic); and a button (see Figure 2). 

The DropDownList and CheckBoxList controls 
have their AutoPostBack property set to true, so the 
form posts the new values automatically whenever the 
user changes a setting. However, the TextBox control's 
AutoPostBack property is False because you don't 
want to build a new label whenever the user types a 
key in that field. After changing the text, the user can 
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post the form by pressing the Enter key or 
clicking on the Make Label button (see 
Figure 3). 

What's Behind 
the WebForm 

All the work happens in the Page_Load 
event. The page must return two differ- 
ent types of data. When the WebForm 
first loads, you want to create the UI 
controls, fill the dropdown lists with 
font and color names, and display the 
results in the browser. So, code the Re- 
sponse. ContentType as text/html. How- 
ever, you also need to use the selected 
information to create an image. For the 
browser to interpret the response as an 
image, the Response. ContentType must 
be a recognizable image rype — in this 
case, image/gif. 

One way to solve this problem is to 
create the image, write it to disk, and set 
the image control's imageURL property 
to point to the image file. However, that 
requires file IO, and there's no need to 
save the image to disk if you can create 
and deliver it from memory. Therefore, 
the Load event sets the image control's 
imageURL property so it requests the 
defineLabel.aspx page again, but with a 
getlmage parameter set to True. In addi- 
tion, the Load event adds parameters for 
the selected values because the browser 
tag makes a GET request to retrieve the 
image rather than a POST request, mak- 
ing the form values unavailable during 
rhe request (see Listing 1 ) . The WebForm 
translates the imageURL property into 
the src attribute for the <img> tag when 
it builds the HTML response for the 
page. Fot example, the WebForm re- 
turns this default src value from the ini- 
tial page load: 

src=" /Label Ma ker/defineLabel .aspx? 
getImage=True&amp ; text=Enter 1 abel 
text here&amp ; f ontname-Tahoma&amp ; 
fontsize-12&Bold=True& 
Ital ic=True&BackCol or- 
Bl ack&amp : ForeCol or=Yel 1 ow" 
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Figure 2 Create the LabelMaker WebForm. These are the default user interface settings 
for the LabelMaker application. The application lets a user request a label with the specified 
text, font, colors, and border. 
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Figure 3 Changing the Settings Causes the Label to Change. Users can experiment 
interactively with the label settings. The image changes immediately when users change a 
font, color, or border setting. The button lets users submit their changes after altering the 
label text. 



When the image control requests the image using this src 
attribute, the getlmage parameter is "True", and the Load method 
returns a GIF image. 

Part of the Load event sets up and calls the getlmage function (see 
Listing 2). Note that the code in Listing 2 doesn't use some of the 
defined variables, but you'll use them later to build the UI values. 

When the getlmage value is "True", the portion of the Load 



method shown in Listing 2 parses the settings from the Request 
object. The code creates a String object that holds the label text, a 
Font object with the appropriate font name and font size settings, 
and two Color objects for the backcolor and forecolor values. It 
passes these four objects to the getlmage function that creates the 
image (see Figure 3). 

Interestingly, building the image-creation code itself is the 
simplest part of this exercise. It took me much longer to figure out 
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When you're releasing new 
software, the last thing you 
want is a support nightmare. 
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reasons you should choose 
CrypKey to protect your 
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software-based copy 
protection, with reliability 
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how to get the Font and Color names into 
the dropdown lists, as neither operation is 
particularly intuitive. In the .NET Frame- 
work, the System. Drawing.FontFamily class 
holds the list of installed fonts in a collection 
class called the InstalledFontCollection. That 
collection has a Families property that re- 
turns an array of FontFamily objects. You 
can iterate through the array of FontFamily 
objects using the getName method on each 
object to retrieve the installed font names: 

Private Function getFontsO As _ 
ArrayLi st 

Dim fontFamilies As Array 
Dim arr As ArrayList = New _ 

ArrayListt ) 
Dim aFamily As _ 

System. Drawi ng . Font Fami 1 y 
Dim fami 1 i es As _ 

InstalledFontCollection = New _ 

System. Drawi ng .Text . 

Instal 1 ed Font Col 1 ecti on( ) 

fontf ami lies = f ami 1 ies . Fami 1 ies 
For Each aFamily In fontFamilies 

arr.Add(aFamily.GetName(0) ) 
Next 

Return arr 
End Function 

The color names are in the System.- 
Drawing.KnownColor enumeration. Using 
capabilities inherited from Reflection 
(runtime discovery of an object's capabili- 
ties, such as property names, method names, 
and parameter types), you can call the 
GetNames method on an enumeration to 
obtain a list of the item names in the enu- 
meration. You pass the GetNames method 
a System.Type value — in this case, the type 
of the enumeration itself. All objects inherit 
the GetType method from the root Object 
class, so you can enumerate the color names 
by using code that fills the dropdown boxes 
with the color names (download Listing 3 
from the VSM Web site; see the Go Online 
box for details). 

Add Borders 

The borders aren't part of the image. In- 
stead, whenever you post the form, the Load 
method changes the Image control's Style 
attribute to reflect the current border color 
and width selections: 

imgLabel . Styl e.Addf. "border-col or" , _ 
comboBorderCol or .Sel ected Item. Text ) 



POP, SMTP, FTP, HTTP, Sockets, 
RAS, UDP, Encoding, Decoding, 
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UUencoding, DNS resolution, 
Time, News (NNTP), Ping, TraceRt. 
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VB.NET • The getlmage Function Creates the Text Label 



Public Function getlmagetByVal s As String, _ 
ByVal aFont As Font. ByVal BackColor As 
Color, ByVal ForeColor As Color) As Bitmap 
Dim b As Bitmap - New Bitmapd, 1) 
' Create a Graphics Class to measure the text width 
Dim aGraphic As Graphics = Graphi cs . Fromlmage(b) 

' Resize the bitmap to the width of the 
' rendered text 

b - New Bitmap(CInt(aGraphic.MeasureString( _ 
s, aFont) .Width) , CInt _ 
(aGraphic.MeasureStringts, aFont). Height)) 

' Reset the Graphics object to the new bitmap 
aGraphic = Graphi cs . FromImage( b) 



' Fill the background with the selected color 
aGraphic.Clear(BackColor) 

' Set up antialiasing 
aGraphic. TextRenderi ngHi nt = _ 
TextRenderingHint.AntiAl ias 

' Draw the text 

aGraphi c . DrawStri ng( s , aFont. 

New Sol idBrush( ForeCol or ) , 0, 0) 
' Clean up 
aGraphic. Fl ush( ) 
' Return the bitmap 
Return b 
End Function 



Listing 1 The parameters specify the label text, font, text, and background colors. The function creates a Bitmap object and a 
Graphics object, sizes the bitmap to an appropriate size to hold the text drawn in the specified font, then draws the text. It returns the 
finished Bitmap object. 



img Label . Styl e . Add ( "border -width " , 
comboBorderSi ze . Sel ec ted I tern. Text ) 



colors list. Use the System. Web. UI.WebControls.BorderStyle enu- 
meration to get the BorderStyle names: 



Separating the border from the image simplifies the code, en - New System. Web. UI .WebControl s . BorderStylet ) 

increases label reusability, and offloads border processing and For Each BorderStyle In en . GetNames(en .GetType ) 
rendering to the client. Populating the BorderStyle DropDownList comboBorderStyl e . Items . Add ( BorderStyl e ) 

control with the available BorderStyles is similar to populating the Next 
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SftBox - Combo 
Box 
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columns, headers, column reordering, 
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Remember that the Page_Load code per- 
forms three separate tasks: initial setup, in- 
cluding the loops to fill the font, color, and 
border-type lists; gathering the user control 
selections to build the Image control's src 
attribute value; and creating and returning 
the label in response to the browser's request 
for the image (download the complete code 
in Listing 4). 

The LabelMaker WebForm shows the 
power of .NET and WebForms clearly. 
You need only a few lines of code to create 
a WebForm with a user interface that lets 
people involved in Web site development 
create custom GIF labels. In contrast, build- 
ing the equivalent application in classic 
ASP requires a COM component and nu- 
merous API calls. For many businesses, 
applications like this more than pay for the 
.NET upgrade costs in only a few months. 

Ideally, you should move the image cre- 
ation code out of the WebForm user inter- 
face code by placing it in a Web Service 
dedicated to creating and returning only the 
images. By doing so, you could refresh only 
the image control contents rather than re- 
drawing the entire UI for each change to the 
image specifications. You could add con- 
trols easily to specify a maximum label width. 
This lets users create multiple labels with the 
same width. You could also add controls to 



102 



Visual Studio Magazine • September 2001 • www.vbpj.com • www.vcdj.com 



VB.NET • The Page_Load Code Obtains the Settings 



Private Sub Page_Load(ByVal sender As _ 
System. Object, ByVal e As 
System. EventArgs ) Handles MyBase.Load 
Dim aFontname As String 
Dim imgFormat As _ 

System. Drawi ng . I magi ng . I mage Format 
Dim labelText As String 
Dim aFont As Font 
Dim aFontSize As Integer 
Dim aFontStyle As FontStyle 
Dim bmp As Bitmap 
Dim i As Integer 
Dim aColor As Color 
Dim BColor As Color 
Dim FColor As Color 
Dim BorderColor As Color 
Dim BorderSize As Integer 
Dim aColorName As String 
Dim en As System. Enum 
If Request . I tem{ "get Image" ) ="l>ue" Then 

' return a GIF image 

' set the content type 

Response . ContentType = "image/gif" 

' get Request parameter values 
labelText = Request . Item( "Text" ) 
aFontname = Request. Itemt "fontname" ) 
aFontSize - Request . Itemt "fontsi ze" ) 

' create background/text Color objects 
BColor = System. Drawi ng . Col or . _ 

FromNamet Request. Item("BackCol or")) 
FColor = System. Drawi ng . Col or . _ 

FromName (Request. It em ("ForeColor")) 

' set the font style value 

aFontStyle = FontStyl e . Regul ar 

If Request . Itemt "Bol d" )="True" Then 

aFontStyle += aFontStyl e . Bol d 
End If 

If Request . Item( " Ital i c" ) ="True" Then 

aFontStyle += a FontStyl e . I ta 1 i c 
End If 

If Request . Itemt "Underl i ne" ) -"True" Then 

aFontStyle += aFontStyl e . Underl i ne 
End If 

If Request . Itemt "Stri keout" ) ="True" Then 

aFontStyle += FontStyl e . Stri keout 
End If 

aFont = New FonttaFontname, aFontSize, 
aFontStyle, Graph icsUnit.Point) 

bmp = getlmagetRequest. Item _ 
("text"), aFont, BColor, FColor) 

bmp. Save ( Response . Output St ream, 
imgFormat . Gi f) 

Response. Endt ) 
End If 

' Page UI Code Here 
End Sub 



Listing 2 The Page_Load event code reads Request object 
parameter values to obtain the settings required to create the 
label image. Page_Load creates a Font object and sets its 
properties according to the user's selections, and creates two 
Color objects for the text and background colors. It sends these 
values to the getlmage function (see Listing 1 ) to obtain the image. 



let users move and rotate the label text within the generated image. 
Finally, you could perform the image creation on the client and 
avoid the frequent round trips to the server when the .NET 
Framework becomes widely distributed, vsm 



A. Russell Jones, Ph.D., is the senior Web devel- 
opment editor for DevX. He's a former reptile 
keeper and professional musician who now com- 
poses computer applications. He's the author of 
Visual Basic Developer's Guide to ASP and IIS and 
Mastering Active Server Pages 3(both published by 
Sybex). Reach him bye-mail atarjl ©northstate.net. 
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Use Batches for Faster 
Throughput 



Get faster SQL Server processing by executing multiple commands together. 



Technology Toolbox 



□ VB.NET 

□ C# 

ffifSQL Server 

□ ASP.NET 

□ XML 

□ VB6 
fflf Other 

Microsoft Access 2000 




Resources 



• Inside Microsoft SQL 
Server 2000by Kalen 
Delaney [Microsoft Press, 
2000, ISBN: 0735609985] 

• Sams Teach Yourself 
Microsoft SQL Server 2000 
in 21 Daysby Richard 
Waymire and Rick Sawtell 
[Sams, 2000, ISBN: 
0672319691] 

•Microsoft SQL Server 
site: www.microsoft.com/ 
sql/default.asp 

• DevX Database Dev Zone: 
www.devx.com/dbzone/ 
defaultsql.asp 



You're wasting time if you're processing Transact- 
SQL statements one at a time in your applica- 
tions. Using batches — a set of SQL Server commands 
executed together — can speed up your database pro- 
cessing operations, sometimes up to tenfold. In this 
column, I'll show you how to add a few types of 
batches — scripts, procedures, and functions — to your 
applications. You'll create a sample stock trading 



by John Pearson 

application that demonstrates the use of batches 
(download the code project from the VSMWeb site; 
see the Go Online box for details). 

You can optimize your use of batches in two ways. 
First, send multiple commands together rather than 
processing them one at a time. Script files, procedures, 
and functions are all types of batches — so are the 
commands you execute from within Query Analyzer. 




Figure 1 Diagram Your Key Relationships. Enterprise Manager's Diagram tool allows you to 
foreign key relationships to your database quickly. Note that StockID and CustomerlD are the 
key columns. 



add the 
primary 
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Second, use stored procedures whenever fea- 
sible. These save time because SQL Server 
saves the execution plan for stored proce- 
dures, so you don't have to parse and compile 
them each time you use them. 

Looking at how SQL Server processes 
commands can help you understand why 
you should use these principles. SQL Server 
performs three steps when it receives a batch 
of commands from a client (that is, you). 
First, it parses the command by checking the 
syntax and transforming the data for the 
compiler. Second, SQL Server compiles the 
query and generates an optimized execution 
plan. This step includes verifying tables with 
their constraints and checking security. Fi- 
nally, SQL Server executes each step of the 
generated plan. In addition, you need to 
consider the overhead of communicating 
between the client and the server. 

Now, think about ways to reduce the 
steps needed to add 100 different records to 
your database. Sending each record one at a 
time multiplies the communication over- 
head and the startup time for parsing, com- 
piling, and executing 100 times. On the 
other hand, sending the 100 records to be 
processed all at once reduces the startup and 
communications overhead by 99 times. 

Create the Stocks 
Database 

Get started with your stock trading applica- 
tion by creating the Stocks database. Issue 
this command in Query Analyzer: 

Create Database Stocks; 

Next, create the necessary tables for your 
stock trading application. You begin with the 
Stock table, which includes StockID, Name, 
TradingName, Price, PriceDate, and Percent- 
Change columns. (Download the complete 
table layout for all the stock tables from the 
VSM Web site.) Including the Price, Price- 
Date, and PercentChange columns in the 
Stock table denormalizes the database, but do 
it for faster lookups later. The StockID field 
is a unique field that isn't related to the data. 
The TradingName field is an abbreviation 
commonly used for stock trading. The 
PercentChange is a calculated field that fig- 
ures the percent change from the previous 
price to the current price. In this example, I 
used int for simplicity's sake. In a real-world 
application, you might use uniqueidentifier 
in this and other ID fields, so you're not 
tempted to refer to the data by its ID number. 
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Figure 2 Access Your Data. Microsoft Access provides a quick way to work with your 
database. Here you've entered the data from the Stock table. 



You now need a way to keep track of the 
prices; hence, the StockPrice table. In this 
example, include StockID in the StockPrice 
table as a foreign key to relate back to the 
Stock table. The Customet table includes 
CustomerName and fields for the customer 
information. Include a CustomerCash field 
to track the amount of cash the customer has 
on hand. The CustomerStock table includes 
the CustomerlD and StockID as foreign 
keys that relate the CustomerStock table 
back to the Customer and Stock tables re- 
spectively. It also includes NumberofShares, 
which is a running total. 

The information in the Transactions 
table (the "s" is necessary to avoid namespace 
collision with the Transaction keyword) is 
sufficient to re-create the transactions' key 
details: TransactionID, StockID, Price, 
PriceDate, CustomerlD, NumberOfShares, 
and Transaction Type. It also provides the 
transaction record for the level of detail 
you're keeping. 

There are some important relationships 
between the various tables (see Figure 1). In 
your database, StockID and CustomerlD are 
the primary key columns you use to link the 
tables together. To do this, open up the Stocks 
database in the Enterprise Manager, right- 
click on Diagrams, then select New Database 
Diagram. The Create Database Wizard ap- 
pears, allows you to add all the tables you've 
just created to the diagram, and displays them 
on the screen with their contents. 

Populate the Data 

You can populate the tables in several nifty 
ways. Ifyou have a medium-to-large amount 
of data, you can copy data easily by using 
either Data Transformation Services (DTS) 
or Bulk Copy Program (BCP). However, 
with the small amount of data used in the 
sample application, I looked up informa- 
tion for a few stocks online, made up some 
customers, then used Microsoft Access 2000 
to enter the data quickly (see Figure 2). 



Now that you have your tables and some 
data, you want your application to do a few 
things: Get Stock Price, Add New Stock 
Price (to the StockPrice table), and Update- 
StockFromStockPrice without Purchase 
Stocks, Sell Stocks, Customer Purchase 
Shares, Customer Sells Shares, and Process 
Customers. 

First, you need to be able to get a current 
price for your stocks. Begin by opening your 
database in the Query Analyzer and entering 
this code in the edit window: 

Use Stocks; 

Select Price from Stock where 
StockID = 1; 

Then, execute the query by clicking on the 
green right arrow on the toolbar to get the 
price. You'll see that the answer is 84.00 — 
the price for the stock with a StockID of 1 . 

Now that you have an idea ofwhat you're 
after, use this complete text of Get- 
StockPrice.sql: 

USE Stocks; 

Declare (StmpStockID as int: 
Declare @tmpPrice as numeric; 

Set @tmpStockID - 1; 

Select @tmpPrice=Price from Stock 
where 

StockID = ©tmpStocklD; 
Set OtmpPrice = @tmpPrice * (1.00 + 
(RandO - 0.5)); 

Print @tmpPrice; 

You can execute this command from within 
Query Analyzer with the EXEC command. 
However, as you read earlier, you obtain 
your greatest advantage by taking SQL 
code and putting it in a stored procedure in 
your database. 

To do that, you can work in the Enter- 
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prise Manager most easily. So, leave the Query Analyzer open, 
open the Stocks database in Enterprise Manager, right-click on 
Stored Procedures, and choose New Stored Procedure. This 
stored procedure is created already if you run the script in the 
sample code: 

CREATE PROCEDURE GetStockPn' ce 
©paramStockID as int. 
©paramPrice as numeric OUTPUT 

AS 

Select @paramPri ce=Pri ce from Stock 

where StockID = @paramStockID; 
Set @paramPrice = @paramPriee * (1.00 + 

(RandO - 0.5)); 

This procedure looks up the price from the Stock table where the 
StockID equals @paramStockID, then modifies that price by a 
random percentage (essentially adding or subtracting up to 50 
percent of the price) and stores the amount in the @paramPrice 
variable. When the procedure completes, the query returns the value 
in @paramPrice to the client. 

Ifyou're done looking at the statements and they pass the "Check 
Syntax" test, click on OK to save the procedure. You've now created 
a batch — which also happens to be a stored procedure. 

Now, back to the Query Analyzer to test it. Enter this code into 
the Query Analyzer window: 

Use Stocks: 

Declare @tmpPrice as numeric; 

Select @tmpPri ce-Pri ce from Stock where 

StockID - 1: 
Print 'The Original Price is ' + 

CAST(@tmpPrice as varchar(80) )+ '.'; 

EXEC GetStockPrice l,@tmpPrice OUTPUT: 
Print 'The New Price is ' + 

CAST(@tmpPrice as varchar(80) )+ '.'; 

This procedure begins by creating a temporary variable (@tmpPrice) . 
You then execute a SELECT statement and store the stock price in 
that variable. For debugging, print the price's value next, then 
execute the GetStockPrice procedure with the StockID number (1) 
and price (@tmpPrice) passed as variables. When you execute the 
function, add the word OUTPUT so the function returns a value 
in the variable @tmpPrice (otherwise, the value isn't returned). Last, 
print the new price. The output looks something like this: 

The Original Price is 73. 
The New Price is 86. 

Add More Stored Procedures 

You might have noticed you're not getting a new price for the stocks 
and the stock price isn't updated yet. If you create an online stock 
processing application, I suspect you'd use an online data source to 
update your price. For the sample application, you'll use Rand() to 
generate random variations in stock prices (which might be pretty 
close to the real thing). You update the price, though, with a 



combination of the next two procedures: AddNewStockPrice and 
UpdateStockFromStockPrice. 

The AddNewStockPrice procedure's purpose is to get a new 
stock price, insert a new record into the StockPrice table with the 
new information, then update the Stock table with the new infor- 
mation. Use this procedure: 

CREATE PROCEDURE AddNewStockPrice 

@paramStockID int = 

AS 

DECLARE etmpPrice numeric; 
DECLARE OtmpPriceDate datetime; 

Set @tmpPriceDate = GetDateO; 

EXEC GetStockPrice 

@paramStockID,@tmpPrice OUTPUT 

Insert into StockPrice 

(Stockld.Price.PriceDate) 

Values (@paramStockID ,@tmpPri ce . 
©tmpPri ceDate ) ; 
EXEC UpdateStockFromStockPrice 

@paramStockID,@tmpPri ce. 

OtmpPriceDate; 

Notice that this procedure calls the GetStockPrice procedure, so 
you can call one procedure from another. It also calls the 
UpdateStockFromStockPrice procedure (see Listing 1). This pro- 
cedure takes information from the StockPrice table, calculates a 
percentage of change from the last price, and stores the informa- 
tion in the Stock table. 

These procedures combine to give you a way to get your new stock 

T-SQL • Update Stock Price Information 



CREATE PROCEDURE UPDATEStockFROMStockPri ce 
(SparamStockID INT. 
@paramStockPrice NUMERIC, 
@paramPriceDate DATETIME 
as 

DECLARE @tmp01dPrice as NUMERIC: 
DECLARE @tmpPercentChange as NUMERIC; 

SELECT ©tmpOldPrice = Price FROM Stock WHERE 
StockID = ©paramStockID and Price > 0.00: 

SET ©tmpPercentChange = ( (@paramStockPrice - 
@tmp01dPrice) / @tmp01dPrice) * 100.00; 

UPDATE Stock SET Price = @paramStockPri ce WHERE 

StockID = (SparamStockID; 
UPDATE Stock SET PriceDate - @pa ramPri ceDate 

WHERE 

StockID - SparamStockID; 
UPDATE Stock SET PercentChange - 
OtmpPercentChange 
WHERE StockID = SparamStockID; 



Listing 1 This procedure gets the stock price information from 
the StockPrice table. It then calculates the percentage of change 
and uses the information to update the Price, PriceDate, and 
PercentageChange fields in the Stock table. 
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price, store the prices to a separate table periodically (for historical and 
analytical reasons), then update your original Stock table. 

You need both Purchase and Sell procedures to buy and sell stock. 
Look at the PurchaseStock procedure (download Listing 2). The 
PurchaseStock and SellStock procedures (not shown here) allow for 
the purchase and sale of unlimited quantities of stock. Their key 
events check for cash, create or update a CustomerStock record for the 
type of stock purchased, update the CustomerCash amount in the 
Customer table, then create a transaction record. 

The key portion of the CustomerBuyOneShare function checks 
the Stocks table for the stock with the highest return and buys only 
one share; you can add the calculations for more than one later 
(download Listing 3). 

Use a procedure named ProcessOneCustomer with these key 
statements to automate the buying and selling for each customer: 

EXEC CustomerBuyOneShare OparamCustomerlD; 
EXEC CustomerSenOneShare @paramCustomerID; 

When calling these stored procedures, you must provide the 
CustomerlD parameter so the procedure knows which customer is 
buying and selling. Finally, use the ProcessAllCustomers function 
to process all the customers (download Listing 4). This function 
loops through the customer table, looks for customer IDs, then 
processes each customer one at a time, having each customer buy 
one share and sell one share during each iteration. 



Nowyou can add a few more things to the application, such as error 
checking, a real data source, an improved way to check for the highest 
return, and the ability to buy shares from other customers, vswi 



John Pearson does intranet development and programs in VB and 
C++ for The Church of Jesus Christ of Latter-day Saints. He has 
contributed to several magazines, including Web Techniques, Web 
Review, and Java Pro. He plays basketball, writes award-winning 
lyrics, and serves with the Army Reserve in his spare time. E-mail him 
at pearsonjv@ldschurch.org. 
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Emulate VB.NET 
Error Handling 



Extend VB6's error handling with a Try-Catch-Finally technique 
akin to what you'll find in VB.NET. 



□ VB.NET 

□ C# 

□ SQL Server 

□ ASP.NET 

□ XML 
HTVB6 



Resources 



• Advanced Visual Basic 6: 
Power Techniques for 
Everyday Programs by 
Matthew Curland 
[Addison-Wesley, 2000, 
ISBN: 0201707128] 

• "A Crash Course on the 
Depths of Win32 Struc- 
tured Exception Handling" 
by Matt Pietrek: 
www.microsoft.corn/msj/ 
defaultframe.asp?page=/ 
msj/0197/Exception/ 
Exception.htm 

• Black Belt Programming, 
"No Exception Errors, My 
Dear Dr. Watson," by 
Jonathan Lunman [Visual 
Basic Programmer's 
Journal May 1999] 



Of the many new features and functions in 
VB.NET, one of the most anticipated is true 
structured exception handling — otherwise known as 
Try-Catch-Finally exception handling. Visual Basic 
has a long history of less-than-robust error handling, 
but you can't escape the fact that exception handling 
is a crucial part of your job. Ignoring it can have 
serious repercussions on the deployment and main- 
tainability of any application. 

I'll describe a Try-Catch-style structured excep- 
tion handling mechanism that works in VB6, right 
now, with minimal fuss (see the sidebar, "Not True 
Try-Catch, But Close Enough"). This technique 
works in all execution modes: IDE for debugging, 
compiled pseudocode and compiled native code, 
with or without optimizations. Finally, this frame- 
work integrates smoothly with VB's own error han- 
dling and can extend it in many ways. 

Purists might want to stop reading now. The 
required code — not exactly straightforward — relies 
on undocumented facets of the VB6 compiler that 
I've verified through the tedious disassembly of vari- 
ous VB projects. 

Error handling in Visual Basic projects generally 
resembles combinations of these four patterns: 

• Forwarded handling: No explicit error handling. 
Either the procedure can't raise errors or it defers 
them to the caller. 

• Transactional error handling: The procedure 
either executes successfully or fails completely, 
much like a database transaction. 

• Structured handling using ON ERROR GOTO: 



by Darin Higgins 

One or more traditional VB error-handling 
blocks. Usually requires line labels and can be 
cumbersome to maintain. 
• Inline error handling: Seems to be the most 
popular way to handle errors in VB. Uses ON 
ERROR RESUME NEXT to trap and test for 
error conditions. 

All these methods tend to leave some portion of a 
procedure's code vulnerable to unhandled errors. 
This is especially true in a multiprogrammer environ- 
ment. And for all the work it takes to implement these 
methods, each yields nothing more than simple error 
handling. An exception-handling framework should 
provide expanded debugging support. 

When I started, I knew only that I wanted Try- 
Catch exception handling similar to what VB.NET 
will support and what C and C++ have supported for 
some time: 

Try 

I Error-protected block of codel 

Catch 

(Block of code that handles errors raised 
in the Try block above! 
Finally 

(Any cleanup code that should always be 

executed 1 
EndTry 

My first approaches relied on numerous line la- 
bels. I threw those out quickly because of their 
complexity and difficult maintainability. Next, I 
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looked at a hybrid, using Goto and Select Case, but I discarded it for 
many of the same reasons. 

The Approach Solidifies 

Finally, I started playing around with the If statement. Eventually, 
I settled on a pseudocode version that looks like this: 

If TryO Then 

{block of code to execute! 
Elself CatchO Then 

{block of code to catch the errorl 
Elself Finally!) Then 

{block of cleanup codel 
Endlf 
EndTryO 

Each of these functions eventually became a method of the Excep- 
tion object in the code accompanying this article (download it from 
the KSMWeb site; see the Go Online box for details) . This approach 
provides a number of benefits and compartmentalizes the details of 
the error-handling code nicely (download the sidebar, "Additional 
Notes About Exc.Cls"; see the Go Online box for details). 

^ Not True Try-Catch, But Close Enough ^ 

The biggest difference between true Try-Catch exception han- 
dling and the technique I present lies in the reliance on the error- 
handling prologue. The prologue is a single chunk of code- 
virtually identical everywhere it's used — that sets up VB's error- 
handling mechanisms, creates an Exception object, and directs 
code execution during an error. .NET and C++ don't require it. 
The prologue adds a degree of flexibility: 

• Resume, Resume Next, and Resume {line label} are all ac- 
counted for and easily accessible during IDE debugging. 

• The error trap covers all code in the procedure, not just the 
Try block. 

• The prologue allows a convenient place to track the name of 
the executing procedure (something native VB should do but, 
sadly, doesn't). This helps tremendously when tracking down 
elusive bugs. 

Finally, this implementation cannot recover from code edits 
while running in the IDE. In other words, if after stepping into a 
Try block you change any code in the current procedure, VB 
recompiles the entire procedure and relocates it to another block 
of memory. The stored return addresses will no longer be valid, 
and there's no good way to correct them. If you simply ignore this 
situation, you'll copy an invalid return address onto the stack, and 
I can guarantee you'll crash the IDE. This article's online code 
detects this situation, displays a message box, and performs a 
STOP (see the Go Online box for details). But it's up to you to 
navigate back out of the Try-Catch block at that point. 

Fortunately, this affects execution only while in the IDE, and 
it affects only the procedure that has been modified while being 
executed. So in practice, this isn't a great limitation, but you 
should be aware of it. 
, 



This technique contains no line labels, so you can't get to the 
Catch block when an error occurs in the Try block, nor can you 
access the Finally block when the Try block succeeds. 

I needed to get from inside the EndTryO function to either the 
Catch or Finally block. If I set internal flags, I could solve the 
problem simply by jumping to the initial Try() function. Using 
flags, Try() could return False, and Catch() or FinallyO would 
return True as appropriate to execute the proper block. 

Any call to a function pushes a return address on the stack, so I 
could solve the problem by remembering the return address when 
Try() is first called and replacing the EndTryO call's return address 
with that memorized address. 

Before unraveling the stack, however, I had to take care of one 
detail you can't avoid when handling VB errors: the VB ON 
ERROR statement. After weeks of examining disassembly listings 
of how VB handles errors internally, it was clear that "faking" VB's 
error-handling mechanisms would require a tremendous amount of 
work. Accepting that, how could I make VB's error handling as easy 
as possible to work with and still have it handle everything a program 
could throw at it? 

To keep things simple, I wanted a single chunk of code — called 
a prologue — that I could paste into a procedure easily and that 
required little or no maintenance. This prologue had to provide the 
hooks necessary to enable Try-Catch and any additional extensions 
to VB's error handling (see Figure 1). Also, I wanted an object that 
would encapsulate as much of the error-handling details as possible 
(the Exception or Exc object). I ended up with this: 

On Error Goto Problem 

Dim Exc as Exc: Set Exc = New Exc 

Probl em: 

Select Case Exc.HandleO 
Case EH E_N0 N E 
Case EHE_RESUME 

Resume 
Case EHE_RESUMENEXT 

Resume Next 
Case EHE_RESET 
Resume Problem 
End Select 

Where's the Stack? 

With hooks into VB's error-handling mechanisms in place, I faced 
the next task — finding the stack frame's location. In assembler, such 
a task is trivial: 

MOV EAX, EBP 

You could write a C DLL to perform the function, but then you 
wouldn't have a purely VB solution. Also, external DLLs can 
become corrupted or disappear. I decided that using a C DLL in 
any way during error handling would introduce too much room 
for instability. 

I could wire up an assembler proxy a la Matthew Curland in 
Advanced Visual Basic 6: Power Techniques for Everyday Programs 
(see Resources). I like the technique, but I thought it was too 
involved for this particular application. 

Remember: Local variables are, in fact, stack-allocated objects. 
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The i386 architecture builds the stack down in memory. Pushing 
items onto the stack actually decrements the stack pointer. So the 
solution was simple: Get the VarPtr of a local variable. The returned 
value is the address of a location on the stack. Maybe not the location 
you need, but it's certainly a good place to start. 

You have the address of a location on the stack, and that address 



is of a local variable. This means the return address must reside 
somewhere up the stack. 
But how far? 

At this point, the source code of the VB compiler and IDE would 
help. But I'm not privy to such things, so I had to rely on assembly, 
hexadecimal dumps, and trial and error to answer that question. 



Your procedure 



I f Exc . Try ( ) Then . . . 
The Try() function returns 
True, so start executing the 
code in the Try block. 

Error occurs. 



Error prologue 



Exc.HandleQ 



Execution is back in the 
procedure code right after 
the Exc.Try(). The return 
value is False this time, so 
skip the Try block and jump 
to the Catch block. 



Catch block executes and 
falls out of If statement. Call 
Exc.EndTryfJ. 



Execution is back in 
procedure code right after 
the Exc.TryO again. The 
return value is False this 
time, so skip the Try and 
Catch blocks and jump to 
the Finally block (if any). 



The Finally block executes 
and falls out of If statement. 
Call Exc.EndTry() again. 



Execution continues after 
the Exc.EndTry(). 



VB jumps to the error 
handler in the prologue. 



Prologue jumps to the 
EXC_RESET case. Use 
RESUME PROBLEM to 
reset VB's error handler, 

then call back 
into the HandleQ function. 



Handle function sets flags, 
saves error state, and 
returns. 



This time, alter the stack to 
return right after the Try() 
function, and set the return 
value to False. 




EndTry() checks and sees 
the Finally block has not 
been executed. Set flags to 
prevent the Try and Catch 
blocks from executing and 
alter the stack as before. 



EndTry() checks and sees 
the Finally block has been 
executed, so clear flags and 
simply exit. 



Figure 1 Tame a Wild Error. To accommodate Visual Basic's exception-handling mechanisms, code execution must pass back and 
forth through the prologue code to the Exception object, which alters the stack appropriately. The prologue re-enables VB's ON 
ERROR at the proper times. 
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Extract the desired return address from the stack like this: 

If IsNati vet ) Then 

Ofs - &H24 
Else 

Ofs = &HC 
End If 

Although you test only IsNative(), you actually have three cases 
here. VB code can execute as either compiled native code, compiled 
pseudocode, or pseudocode in the IDE. Each pushes different 
things onto the stack. However, both compiled pseudocode and 
IDE pseudocode push the same amount of stack. 

In addition, VB provides various optimization combinations 
when compiled to native code. In many cases, these optimizations 
can affect the stack layout. But after ample testing, optimizations 
don't affect the stack of the functions I'm using. 

Munging the Return Address 

As a test, I copied an address over the return address on the stack and 
traced execution in a compiled native-code test app. Execution 
jumped from EndTryO back to immediately after Try(). Success! 

Then I tried the same thing in the IDE and nothing happened. 
What went wrong? I wrote up a quick hexdump function to examine 
memory contents while in the IDE (find this function in the code 
that accompanies this article; see the Go Online box for details). 
Everything looked exactly right, and it still failed. 

Then it struck me. What if the IDE stored the return address in 
two places? One copy was used simply as a reference, but the other 
copy would actually control code execution. Sure enough, I found 
a second copy of the return address up the stack. In fact, it was more 
than 300 bytes up the stack. As a test, I copied my alternate return 
address over this new location. The function returned to the exact 
spot I had wanted. 

But this was a serious roadblock. I needed to retrieve that address 
accurately every time. Eventually, I stumbled on an address located 
&H64 bytes from my local variable up the stack. That location 
contained a pointer to a location exactly 8 bytes above the second 
copy of the return address. So this code can replace the current 
function's return address: 

If IsIDEO Then 

CopyMemory Ofs, ByVal VarPtr(x) + &H64. 4 
Ofs = Ofs - 8 

CopyMemory ByVal Ofs. {new addrl, 4 
Else 

With the low-level mechanics out of the way, I started looking 
at the actual implementation of the Try(), Catch(), and FinallyO 
functions. If an error occurs in the Try block in Try-Catch exception 
handling, the first appropriate Catch block executes, then the 
Finally block executes. 

When Try() executes, you must save the return address from the 
stack into an internal array. Use an array so you can save multiple 
return addresses, which you must do to accommodate nested Try 
blocks. The Try() function then returns True and execution drops 



into the Try block itself. 

If an error occurs, execution jumps to the Problem: label in the 
prologue, which immediately calls Exc. Handle() . Check here for 
any saved Try-block return addresses in the internal array, and 
if you find them, set things up to get back to the Catch blocks. 

The first problem involves getting to the Catch block while still 
being covered by the prologue's error handler. This is important 
because you don't want to leave any of your procedure's code 
vulnerable to an unhandled error. 

This code in Exc.Handle() sets up the recovery: 

If UBound(rTryAddr) > Then 

' force catch handling 

rbCatch - True 

rbFinally = False 

rbResetting = True 

Handle = EHE_RESET 

Exit Function 
End If 

But remember, an active error handler is not covering execution 
at this point because in VB's eyes, you're still executing in an 
error-handling subroutine. Any error encountered now would be 
raised to the caller and would likely crash your program. The 
EHE_RESET signals the prologue code to reset the error handling 
in the procedure: 

Case EHE_RESET 
Resume Problem 

This jumps back to Problem: and re-executes the Exc.HandleO 
function. Now, however, your code is once again covered by VB's 
error-handling mechanisms. 

Once you detect the rbResetting flag inside Exc.Handle(), you 
must restore the state of VBA's Err object, retrieve the saved return 
address (of the Try() function call), copy it over the return address 
of the Exc.HandleO function, and return False from Exc.Handle(). 

Now things get interesting. 

When execution exits Exc.HandleO, VB cleans up the allocated 
stack automatically, puts the False return value in the EAX register, 
and jumps to the address indicated by the return address on the 
stack. I simply replaced that with the Try() function's original 
return address, so the effect on the calling code is that you just 
returned from a call to the Try() function with a False return value. 

This causes the IfTryO Then test to fail, and code execution 
passes to the first Catch block. Once the Catch block completes, or 
the Try block completes without error, execution leaves the If 
statement and calls EndTryO. 

EndTryO might seem extraneous, but it's not. First, it redirects 
execution to the Finally block if all other handling has been 
completed. Try-Catch exception handling requires that the Finally 
block be executed when execution leaves the Try-Catch, regardless 
of the circumstances. Second, it guarantees that unhandled 
exceptions propagate out of the erring procedure to the caller. This 
includes errors in the Try block that have no corresponding Catch 
block, as well as unhandled errors in the Catch or Finally block. 

All Catch() and FinallyO must do is check several internal flags 
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and return the proper values to cause the If statement either to 
execute their block of code or to skip over it. Catch() is slightly more 
involved because I've added the ability to accept a ParamArray of 
error codes to test against (see the Go Online box for details). 

Once execution passes through all the other tests, you must 
execute the Finally block, if any. The FinallyO function simply 
returns True if it's supposed to be executed. The internal rbFinally 
flag will be set in this case. 

I haven't mentioned two routines yet, even though they play a 
pivotal role in this technique. The first, IsIDE(), detects if the 
application is running in the IDE using an unorthodox yet efficient 
approach. The other, IsNative(), detects whether your project is 
compiled pseudocode or compiled native code. Check out the 
online code for details. 

With this framework, you bring structured exception handling 
to the VB6 universe. But there's a lot more to dealing with errors 
than a simple Try-Catch statement — I've designed this frame- 
work for extensibility. You can add a Log method for logging 
errors to a text file or the NT event log and a Show method for 
displaying errors along with additional debugging information. 
You can implement stack tracing, performance monitoring, and 
object instance counting. You can redirect debug output, ignore 
or trap specific errors selectively (see the online code for details), 
and extend the built-in VBA.Err object with additional informa- 
tion such as procedure arguments or internal specifics about the 
operation that failed. And you can trap processor exceptions 



(GPFs). Now that you've learned these exception-handling func- 
tions and stack manipulation techniques, you can construct a 
framework that supports error-handling capabilities beyond what 
even .NET will provide, usm 



Darin Higgins is a freelance programmer and consultant in the 
Dallasarea. He has worked professionally with BASICandVisual Basic 
for more than 13 years, occasionally taking time out to juggle, 
restore Volkswagens, and fly RC helicopters. Reach Darin by e-mail at 
darin.higgins@home.com. 
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You haven't seen your desk in weeks and your code is 
being compromised by a speeding delivery date. 
You're just sleep walking through a nightmare. 

Just as it seems all hope is lost, a colleague, sensing the rising 
stress levels, suggests purchasing components to finish your 
project. He's read about them and seen many products 
advertised, even used a few himself. He says, "products are 
available to add the functionality you need in a flash, 
without endless hours of coding from scratch." 

Yeah right, you think, and then the fairy godmother will 
wave her magic wand and I'll be in Jamaica enjoying a rum 
and Coke on the beach. . . 

No, not quite, but if you're a professional developer, and 
you're going to deliver a high quality, fully functional, 
stable application, on time... without the help of a fairy 
godmother; third party components, well chosen, are your 
best bet and will really slash your development time. 

So how do you know which components to choose? Buy 
components that carry the CVC quality seal, if it has the 
seal, it's a component you can trust. . . 
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The Component Vendor Consortium (CVC) is a non-profit organization committed to 
ensuring developers have access to well-written, thoroughly tested components 
that can be implemented without difficulty. To help you choose components that 
meet exacting quality standards, the Component Vendor Consortium has initiated 
the CVC Quality Certified logo program. This program subjects components to a 
rigorous series of tests, overseen by Compuware Professional Services, an 
independent testing service. To qualify for logo certification, components must 
achieve at least 80% code coverage and must be proven to contain no 
unexplained memory corruption errors, be free of memory leaks, and have no 
unhandled errors or exceptions. When you select a component that carries the CVC 
Quality Certified logo, you can have a feeling of confidence, knowing you're using 
tools designed to keep you developing, not trouble shooting. 

For more information on the CVC quality certification process, including details on 
the testing process and procedure, visit the CVC web site at: 



http://www.components.org/quality.asp 
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Desaware 26 

408-377-4770; www.desaware.com 

DevX 85 

888-963-3389; www.devx.com 

DevX Get Answers 101 



888-963-3389; www.devx.com/knowledgexchange.com 

DevX Marketplace 1 1 1 

888-963-3389; http://marketplace.devx.com 

DevX VB-2-The-Ma x 116 

www.vb2themax.com 

DevX Newsletters 113 

888-963-3389; www.devx.com 

dtSearch 76 

800-IT-FINDS; www.dtsearch.com 

ESDI 19 

www.esri.com 

Exchange & Outlook Newletter 117 

www.exchangeworkshop.com 

FarPoint Technologies 24, 25 

800-645-5913; www.fpoint.com 



FMS Inc. 51 

888-220-6234 ext. 222; www.fmsinc.com 

GigaSoft 63 

www.gigasoft.com 

Imaging Source 22 

877-462-4772; www.textcontrol.com 

Infragistics 1, C2, C3, C4 

800-231-8588; www.infragistics.com 



iNNERHOST 

www.innerhost.com 



InstallShield 

www.installshield.com 

InterSystems Corp. 

www.intersystems.com 

Kenonic Controls Ltd. 

403-258-6200; www.crypkey.com 

Keystone Learning Systems 

800-349-5761 ; www.klscorp.com/vpj 

LEAD Technologies 

800-637-1842; www.leadtools.com 

Mabry 

800-99-MABRY; www.mabry.com 
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Microsoft 

www.microsoft.com 



2, 3, 38, 39, 46, 47 



.NET Magazine Subscriptions 64 

800-848-5523; www.fawcette.com 

In software 42 

919-544-7770; www.nsoftware.com 

Pegasus 40 

800-875-7009; www.pegasustools.com 

Programmer's Paradise 8, 9 

800-445-7899; www.pparadise.com 

Rainbow Technologies 41 

www.rainbow.com 



Sax Software 67 

www.saxsoft.com 

Sequiter Software 54, 67 

403-437-2410; www.sequiter.com 



SoftArtisans 

877-SOFTART; www.softartisans.com 

Softel vdm Inc. 

www.softelvdm.com 

Software FX 

800-392-4278; www.aireweb.com 

SoftWIRE Technology 

www.softwiretechnology.com 

Sprint PCS 

www.sprint.com 

SQL2TheMax 

800-848-5523; www.sql2themax 

VBCD Subscriptions 

800-848-5523 



VCDC Orlando 

800-848-5523; www.vcdc.com 

VSLive! Orlando 

800-848-5523; www.vslive.com 

VSM Subscriptions 

800-848-5523; www.vbpj.com 

Wise Solutions 

800-554-8565; www.wisesolutions.com 

XML Magazine Subscriptions 

800-848-5523; www.xmlmag.com 
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► To get immediate details on prod- 
ucts advertised in this issue, you 
can simply log onto our online ser- 
vices at http://infoasap.devx.com. 

► This will provide a list of direct 
links to this month's advertisers' 
Web sites. 
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Pita. Production Coordinator BS04«3-7140 
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USA, 94301-2500 • 650-833-7100 • 800-848-5523 
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The Missing Business Model 



Web sites have a hard time interoperating between 
themselves. Most are the same architecturally, but 
components developed in one technology cannot 
invoke methods on components developed in another technol- 
ogy. Another complication: The firewalls in every site disallow 
binary calls. Developers today handcraft interoperability 
solutions between businesses. These solutions are proprietary, 
provide singular relief, and are expensive and time-consuming 
to implement. 

Web Services address these problems in an elegant and 
simple fashion. Web Services use HTTP as a transport protocol 
to transport calls from one Web site to the next, and they use a 
higher-level protocol such as Simple Object Access Protocol 
(SOAP) to represent the call payload. Web Services develop- 
ment platforms, such as .NET, enable you to expose and 
consume Web Services with great ease, almost as if the 
interacting components were in the same Web site. 

Microsoft promotes actively the "software as a service" 
notion. It envisions businesses exposing functionality over the 
Web in the form of Web Services, where interested parties can 
consume them as part of their applications. Here's the critical, 
unanswered question: What is the business model for Web 
Services? In other words, how can companies make money 
from Web Services? I see a few possible business models. 
Companies can charge a per-use fee every time somebody uses 
their services. Or they can run a subscription program where 
they collect a flat fee and grant unlimited access to services. If 
the service facilitates some business transaction, the service 
provider can collect a percentile commission of the transaction 
itself. Of course, companies can also expose their services for 
free, then attempt to collect a reward for their efforts in some 
other fashion, whether in the form of recognition, market 
penetration, or access to other services. Companies can also use 
a combination of these business models, such as giving a basic 
set of services free (for market penetration) and charging only 
for the premium services. 

But all these business models have a flaw that makes commit- 
ting to Web Services risky from the service consumer's point of 
view: What prevents the service provider from changing the 
service definition? Changing a published service (its syntax, 
semantics, performance, error handling, and so on) will likely 
break all existing consumers of the service. Imagine a service that 
collects fees per use from its consumers. What should the service 
provider do if it wants to change the service and that change is 
welcomed (or even required) by all but one of the consumers? If 



the change is allowed, that one 
consumer will have to rewrite, 
retest, and redeploy the applica- 
tion. If the change isn't allowed, 
the service provider might lose 
the business of the rest of the 
consumers. 

I believe this risk will prevent 
companies from adopting the 
"software as a service" notion 
until some mechanisms are in 
place to address this problem. 

But you can use Web Services 
in another way. Imagine a 
situation where a company wants 
to access its own application 
across the Internet at a remote 
customer site. Such access is 
useful for support, maintenance, 
and upgrade purposes. In this 
scenario, the company controls 
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sarily the opinions of VSM.j 



both the service definition and its 
use, and is therefore not susceptible to a third party changing the 
service definition. The company uses Web Services only to access 
its application remotely through the customer's firewall. 
Developing such remote-access solutions without Web Services is 
difficult because of the reasons I discussed already. However, 
Web Services make developing such solutions easy. I think this is 
where Web Services will stake their first major claim — in 
situations where companies hold both ends of the stick. 

Web Services have the potential to be the next information 
technology revolution. They promise to change the nature of 
our interaction with the Web and the services ir provides. 
.NET and Web Services will also affect the way each and every 
one of us develops applications, even if only to accommodate 
exposing the application as a Web Service in the future. But, at 
least for the short term, Web Services won't be used the way 
Microsoft hopes, wswi 



Juval Lowy is a seasoned software architect and the founder of 
IDesign, a consulting firm focused on COM and .NET design. Juval 
also conducts training classes and conference talks on component- 
oriented design and development process, and he authored the book 
COM and .NET Component Services [O'Reilly, August 2001). Reach 
him at www.componentware.net. 
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Tools of the trade. 



Infragistics - formed by the merger of Sheridan and ProtoView 



Create robust and dramatic applications that emulate the rich look of Microsoft Office 
2000 with UltraToolBars™, complete with quick customization, personalized menus, 
flyout toolbars and an integrated tab control. We've included even greater value, with 
eleven interface-enhancing controls to stretch your imagination. Our exclusive 
PictureRegion™ technology enables forms and components to adopt virtually any 
shape you can dream up. And, after you've created the perfect application, add the 
finishing touches with 37 attention-grabbing, PowerPoint-style transitions for a 
dramatic, polished interface. 

Powerful components included with UltraToolBars: ActiveTabs™, Resizer, Scroll, Splash, 
Transition, Splitter, Option, Command, Check, Frame, Panel and Ribbon. 

UltraTOOlBarS Key Features: 

■ Multi-featured toolbar control with Office 2000 look and feel 

■ ActiveTabs tab control can be integrated with UltraToolBars or 
used alone 

■ Exciting graphical features including 37 PowerPoint-style 
transitions and ability to reshape forms and controls 

■ Easy-to-use design-time tab control setup 

■ Animated menus and flyout toolbars 

■ Dock toolbars to any window 

■ Advanced splash screen control 

■ Versatile Splitter control 



O Background image 

© Resizer control 

Transition control 

O Scroll control 

© Databound Option 
button 

O Form contained in 
Splitter 

O Flyout toolbar 

© Dock toolbars to any 
window 

© ActiveTabs 

© Animated menus 



Choose the toolset that's right for your 
development requirements. UltraToolBars is 
available separately, and is also included in 
UltraOffice™ and UltraSuite™. 



For detailed information, visit 
www.infragistics.com 

Download Free Trial Version! 
Order Online! or call 800-231-8588 



QUALITY CERTIFIES 



Infragistics; 

Component powered infrastructure 



Copyright 2001 Infragistics, Inc All rights reserved. Infragistics, the Infragistics logo, UltraOffice, UltraSuite, UltraToolBars, PictureRegion & ActiveTabs are trademarks of Infragistics, In 



Java • ActiveX • .NET 



800-231-8588 • infragistics.com 
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Infragistics - formed by the merger of Sheridan and ProtoView 



Optimized for OLE DB technology, UltraCrid's unique features and components provide 
more control and flexibility than ever before. We've incorporated truly innovative 
graphical capabilities, giving the developer the ability to simplify navigation through 
complex data structures while providing eye-popping visual appeal. With new printing 
and print preview capabilities, displayed data can look great on paper, too. 



OLE DB bound 

Advanced non-bound modes 

Powerful per-Band data fetching options 

NEW Printing with Print Preview 

Pre-built user interfaces (ViewStyles) for 

flat and hierarchical representation of data 

Programmable objects provide accessibility at every level 

Cell, Row and Header transparency/translucency 

Built-in Masked Editing 

Background images for Grid, Rows, Cells, Headers, and more 

Built-in dropdown calendar 

Multiple Row and Column Scrolling Regions 

Intuitive context-sensitive hierarchical AddRow Bar 

Advanced Custom Property Pages with wizards 

Croup, Column, Row and Cell objects 

Ability for owner-drawn UlElements 

NEW Save and Load Layouts Collection 

Value Lists 

NEW Data Formatting 

Automatic or Manual multi-column sorting of data 



UltraGrid 2.0 Key Features: L^M 



cue 



O ViewStyle multiband 
vertical 

© Band Headers and 
Auto Preview Area 

Display images and 
data in cells and 
headers 

O Dropdown calendar 
in grid cell 

© AddNewBox 

© Print Preview Screen 



QUALITY CERTIFIED 



Seven powerful input components included 
with UltraGrid: ComboBoxEx, Currency, DateEdit, 
DropDownEdit, HotLink, Numeric and Spin. 

Make the most of your investment- 
UltraGrid 2.0 is available with optional 
Subscription Service.* 

For detailed information, visit 
www.infragistics.com 

Download Free Trial Version! 
Order Online! or call 800-23 1 -8588 



Infragistics^ 

Component powered infrastructure 
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